taurusdb-core 0.1.0

package/dist/config/index.js

@@ -0,0 +1,21 @@
+import { ConfigSchema } from "./schema.js";
+import { buildRawConfigFromEnv } from "./env.js";
+export { redactConfigForLog } from "./redaction.js";
+let configSingleton;
+export function createConfigFromEnv(env = process.env) {
+    const parsed = ConfigSchema.safeParse(buildRawConfigFromEnv(env));
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map((issue) => `${issue.path.join(".") || "<root>"}: ${issue.message}`);
+        throw new Error(`Invalid configuration:\n${issues.join("\n")}`);
+    }
+    return parsed.data;
+}
+export function getConfig() {
+    if (!configSingleton) {
+        configSingleton = createConfigFromEnv(process.env);
+    }
+    return configSingleton;
+}
+export function resetConfigForTests() {
+    configSingleton = undefined;
+}

package/dist/config/redaction.d.ts

@@ -0,0 +1,2 @@
+import type { Config } from "./schema.js";
+export declare function redactConfigForLog(config: Config): Record<string, unknown>;

package/dist/config/redaction.js

@@ -0,0 +1,19 @@
+const SENSITIVE_KEY_PATTERN = /(password|secret|token|credential|apikey|api_key|accesskey|access_key|secretaccesskey|secret_access_key)/i;
+function deepRedact(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => deepRedact(item));
+    }
+    if (value && typeof value === "object") {
+        const output = {};
+        for (const [key, nestedValue] of Object.entries(value)) {
+            output[key] = SENSITIVE_KEY_PATTERN.test(key)
+                ? "[REDACTED]"
+                : deepRedact(nestedValue);
+        }
+        return output;
+    }
+    return value;
+}
+export function redactConfigForLog(config) {
+    return deepRedact(config);
+}

package/dist/config/schema.d.ts

@@ -0,0 +1,417 @@
+import { z } from "zod";
+export declare const ConfigSchema: z.ZodObject<{
+    defaultDatasource: z.ZodOptional<z.ZodString>;
+    profilesPath: z.ZodOptional<z.ZodString>;
+    enableMutations: z.ZodDefault<z.ZodBoolean>;
+    cloud: z.ZodDefault<z.ZodObject<{
+        provider: z.ZodDefault<z.ZodEnum<["huaweicloud"]>>;
+        region: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+        instanceId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+        authToken: z.ZodOptional<z.ZodString>;
+        accessKeyId: z.ZodOptional<z.ZodString>;
+        secretAccessKey: z.ZodOptional<z.ZodString>;
+        securityToken: z.ZodOptional<z.ZodString>;
+        apiEndpoint: z.ZodOptional<z.ZodString>;
+        iamEndpoint: z.ZodOptional<z.ZodString>;
+        domainSuffix: z.ZodDefault<z.ZodString>;
+        language: z.ZodDefault<z.ZodEnum<["en-us", "zh-cn"]>>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "huaweicloud";
+        domainSuffix: string;
+        language: "en-us" | "zh-cn";
+        region?: string | undefined;
+        projectId?: string | undefined;
+        instanceId?: string | undefined;
+        nodeId?: string | undefined;
+        authToken?: string | undefined;
+        accessKeyId?: string | undefined;
+        secretAccessKey?: string | undefined;
+        securityToken?: string | undefined;
+        apiEndpoint?: string | undefined;
+        iamEndpoint?: string | undefined;
+    }, {
+        provider?: "huaweicloud" | undefined;
+        region?: string | undefined;
+        projectId?: string | undefined;
+        instanceId?: string | undefined;
+        nodeId?: string | undefined;
+        authToken?: string | undefined;
+        accessKeyId?: string | undefined;
+        secretAccessKey?: string | undefined;
+        securityToken?: string | undefined;
+        apiEndpoint?: string | undefined;
+        iamEndpoint?: string | undefined;
+        domainSuffix?: string | undefined;
+        language?: "en-us" | "zh-cn" | undefined;
+    }>>;
+    limits: z.ZodDefault<z.ZodObject<{
+        maxRows: z.ZodDefault<z.ZodNumber>;
+        maxColumns: z.ZodDefault<z.ZodNumber>;
+        maxStatementMs: z.ZodDefault<z.ZodNumber>;
+        maxFieldChars: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxRows: number;
+        maxColumns: number;
+        maxStatementMs: number;
+        maxFieldChars: number;
+    }, {
+        maxRows?: number | undefined;
+        maxColumns?: number | undefined;
+        maxStatementMs?: number | undefined;
+        maxFieldChars?: number | undefined;
+    }>>;
+    audit: z.ZodDefault<z.ZodObject<{
+        logPath: z.ZodDefault<z.ZodString>;
+        includeRawSql: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        logPath: string;
+        includeRawSql: boolean;
+    }, {
+        logPath?: string | undefined;
+        includeRawSql?: boolean | undefined;
+    }>>;
+    slowSqlSource: z.ZodDefault<z.ZodObject<{
+        taurusApi: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            endpoint: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            instanceId: z.ZodOptional<z.ZodString>;
+            nodeId: z.ZodOptional<z.ZodString>;
+            authToken: z.ZodOptional<z.ZodString>;
+            language: z.ZodDefault<z.ZodEnum<["en-us", "zh-cn"]>>;
+            requestTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            defaultLookbackMinutes: z.ZodDefault<z.ZodNumber>;
+            maxRecords: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            language: "en-us" | "zh-cn";
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            maxRecords: number;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        }, {
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            language?: "en-us" | "zh-cn" | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            maxRecords?: number | undefined;
+        }>>;
+        das: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            endpoint: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            instanceId: z.ZodOptional<z.ZodString>;
+            authToken: z.ZodOptional<z.ZodString>;
+            datastoreType: z.ZodDefault<z.ZodEnum<["MySQL", "TaurusDB"]>>;
+            requestTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            defaultLookbackMinutes: z.ZodDefault<z.ZodNumber>;
+            maxRecords: z.ZodDefault<z.ZodNumber>;
+            maxPages: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            maxRecords: number;
+            datastoreType: "MySQL" | "TaurusDB";
+            maxPages: number;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        }, {
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            authToken?: string | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            maxRecords?: number | undefined;
+            datastoreType?: "MySQL" | "TaurusDB" | undefined;
+            maxPages?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        taurusApi: {
+            language: "en-us" | "zh-cn";
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            maxRecords: number;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        };
+        das: {
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            maxRecords: number;
+            datastoreType: "MySQL" | "TaurusDB";
+            maxPages: number;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        };
+    }, {
+        taurusApi?: {
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            language?: "en-us" | "zh-cn" | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            maxRecords?: number | undefined;
+        } | undefined;
+        das?: {
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            authToken?: string | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            maxRecords?: number | undefined;
+            datastoreType?: "MySQL" | "TaurusDB" | undefined;
+            maxPages?: number | undefined;
+        } | undefined;
+    }>>;
+    metricsSource: z.ZodDefault<z.ZodObject<{
+        ces: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            endpoint: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodString>;
+            instanceId: z.ZodOptional<z.ZodString>;
+            nodeId: z.ZodOptional<z.ZodString>;
+            authToken: z.ZodOptional<z.ZodString>;
+            namespace: z.ZodDefault<z.ZodString>;
+            instanceDimension: z.ZodDefault<z.ZodString>;
+            nodeDimension: z.ZodDefault<z.ZodString>;
+            period: z.ZodDefault<z.ZodEnum<["1", "60", "300", "1200", "3600", "14400", "86400"]>>;
+            filter: z.ZodDefault<z.ZodEnum<["average", "max", "min", "sum", "variance"]>>;
+            requestTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            defaultLookbackMinutes: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            filter: "average" | "max" | "min" | "sum" | "variance";
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            namespace: string;
+            instanceDimension: string;
+            nodeDimension: string;
+            period: "1" | "60" | "300" | "1200" | "3600" | "14400" | "86400";
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        }, {
+            filter?: "average" | "max" | "min" | "sum" | "variance" | undefined;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            namespace?: string | undefined;
+            instanceDimension?: string | undefined;
+            nodeDimension?: string | undefined;
+            period?: "1" | "60" | "300" | "1200" | "3600" | "14400" | "86400" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        ces: {
+            filter: "average" | "max" | "min" | "sum" | "variance";
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            namespace: string;
+            instanceDimension: string;
+            nodeDimension: string;
+            period: "1" | "60" | "300" | "1200" | "3600" | "14400" | "86400";
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        };
+    }, {
+        ces?: {
+            filter?: "average" | "max" | "min" | "sum" | "variance" | undefined;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            namespace?: string | undefined;
+            instanceDimension?: string | undefined;
+            nodeDimension?: string | undefined;
+            period?: "1" | "60" | "300" | "1200" | "3600" | "14400" | "86400" | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    enableMutations: boolean;
+    cloud: {
+        provider: "huaweicloud";
+        domainSuffix: string;
+        language: "en-us" | "zh-cn";
+        region?: string | undefined;
+        projectId?: string | undefined;
+        instanceId?: string | undefined;
+        nodeId?: string | undefined;
+        authToken?: string | undefined;
+        accessKeyId?: string | undefined;
+        secretAccessKey?: string | undefined;
+        securityToken?: string | undefined;
+        apiEndpoint?: string | undefined;
+        iamEndpoint?: string | undefined;
+    };
+    limits: {
+        maxRows: number;
+        maxColumns: number;
+        maxStatementMs: number;
+        maxFieldChars: number;
+    };
+    audit: {
+        logPath: string;
+        includeRawSql: boolean;
+    };
+    slowSqlSource: {
+        taurusApi: {
+            language: "en-us" | "zh-cn";
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            maxRecords: number;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        };
+        das: {
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            maxRecords: number;
+            datastoreType: "MySQL" | "TaurusDB";
+            maxPages: number;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        };
+    };
+    metricsSource: {
+        ces: {
+            filter: "average" | "max" | "min" | "sum" | "variance";
+            enabled: boolean;
+            requestTimeoutMs: number;
+            defaultLookbackMinutes: number;
+            namespace: string;
+            instanceDimension: string;
+            nodeDimension: string;
+            period: "1" | "60" | "300" | "1200" | "3600" | "14400" | "86400";
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            endpoint?: string | undefined;
+        };
+    };
+    defaultDatasource?: string | undefined;
+    profilesPath?: string | undefined;
+}, {
+    defaultDatasource?: string | undefined;
+    profilesPath?: string | undefined;
+    enableMutations?: boolean | undefined;
+    cloud?: {
+        provider?: "huaweicloud" | undefined;
+        region?: string | undefined;
+        projectId?: string | undefined;
+        instanceId?: string | undefined;
+        nodeId?: string | undefined;
+        authToken?: string | undefined;
+        accessKeyId?: string | undefined;
+        secretAccessKey?: string | undefined;
+        securityToken?: string | undefined;
+        apiEndpoint?: string | undefined;
+        iamEndpoint?: string | undefined;
+        domainSuffix?: string | undefined;
+        language?: "en-us" | "zh-cn" | undefined;
+    } | undefined;
+    limits?: {
+        maxRows?: number | undefined;
+        maxColumns?: number | undefined;
+        maxStatementMs?: number | undefined;
+        maxFieldChars?: number | undefined;
+    } | undefined;
+    audit?: {
+        logPath?: string | undefined;
+        includeRawSql?: boolean | undefined;
+    } | undefined;
+    slowSqlSource?: {
+        taurusApi?: {
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            language?: "en-us" | "zh-cn" | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            maxRecords?: number | undefined;
+        } | undefined;
+        das?: {
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            authToken?: string | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            maxRecords?: number | undefined;
+            datastoreType?: "MySQL" | "TaurusDB" | undefined;
+            maxPages?: number | undefined;
+        } | undefined;
+    } | undefined;
+    metricsSource?: {
+        ces?: {
+            filter?: "average" | "max" | "min" | "sum" | "variance" | undefined;
+            projectId?: string | undefined;
+            instanceId?: string | undefined;
+            nodeId?: string | undefined;
+            authToken?: string | undefined;
+            enabled?: boolean | undefined;
+            endpoint?: string | undefined;
+            requestTimeoutMs?: number | undefined;
+            defaultLookbackMinutes?: number | undefined;
+            namespace?: string | undefined;
+            instanceDimension?: string | undefined;
+            nodeDimension?: string | undefined;
+            period?: "1" | "60" | "300" | "1200" | "3600" | "14400" | "86400" | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export type Config = z.infer<typeof ConfigSchema>;

package/dist/config/schema.js

@@ -0,0 +1,100 @@
+import { z } from "zod";
+const LimitsSchema = z
+    .object({
+    maxRows: z.number().int().positive().default(200),
+    maxColumns: z.number().int().positive().default(50),
+    maxStatementMs: z.number().int().positive().default(15000),
+    maxFieldChars: z.number().int().positive().default(2048),
+})
+    .default({});
+const AuditSchema = z
+    .object({
+    logPath: z.string().min(1).default("~/.taurusdb-mcp/audit.jsonl"),
+    includeRawSql: z.boolean().default(false),
+})
+    .default({});
+const CloudSchema = z
+    .object({
+    provider: z.enum(["huaweicloud"]).default("huaweicloud"),
+    region: z.string().min(1).optional(),
+    projectId: z.string().min(1).optional(),
+    instanceId: z.string().min(1).optional(),
+    nodeId: z.string().min(1).optional(),
+    authToken: z.string().min(1).optional(),
+    accessKeyId: z.string().min(1).optional(),
+    secretAccessKey: z.string().min(1).optional(),
+    securityToken: z.string().min(1).optional(),
+    apiEndpoint: z.string().min(1).optional(),
+    iamEndpoint: z.string().min(1).optional(),
+    domainSuffix: z.string().min(1).default("myhuaweicloud.com"),
+    language: z.enum(["en-us", "zh-cn"]).default("zh-cn"),
+})
+    .default({});
+const TaurusApiSlowSqlSourceSchema = z
+    .object({
+    enabled: z.boolean().default(false),
+    endpoint: z.string().min(1).optional(),
+    projectId: z.string().min(1).optional(),
+    instanceId: z.string().min(1).optional(),
+    nodeId: z.string().min(1).optional(),
+    authToken: z.string().min(1).optional(),
+    language: z.enum(["en-us", "zh-cn"]).default("zh-cn"),
+    requestTimeoutMs: z.number().int().positive().default(5000),
+    defaultLookbackMinutes: z.number().int().positive().max(43_200).default(60),
+    maxRecords: z.number().int().positive().max(100).default(20),
+})
+    .default({});
+const DasSlowSqlSourceSchema = z
+    .object({
+    enabled: z.boolean().default(false),
+    endpoint: z.string().min(1).optional(),
+    projectId: z.string().min(1).optional(),
+    instanceId: z.string().min(1).optional(),
+    authToken: z.string().min(1).optional(),
+    datastoreType: z.enum(["MySQL", "TaurusDB"]).default("TaurusDB"),
+    requestTimeoutMs: z.number().int().positive().default(5000),
+    defaultLookbackMinutes: z.number().int().positive().max(43_200).default(60),
+    maxRecords: z.number().int().positive().max(200).default(50),
+    maxPages: z.number().int().positive().max(10).default(2),
+})
+    .default({});
+const CesMetricsSourceSchema = z
+    .object({
+    enabled: z.boolean().default(false),
+    endpoint: z.string().min(1).optional(),
+    projectId: z.string().min(1).optional(),
+    instanceId: z.string().min(1).optional(),
+    nodeId: z.string().min(1).optional(),
+    authToken: z.string().min(1).optional(),
+    namespace: z.string().min(1).default("SYS.GAUSSDB"),
+    instanceDimension: z.string().min(1).default("gaussdb_mysql_instance_id"),
+    nodeDimension: z.string().min(1).default("gaussdb_mysql_node_id"),
+    period: z
+        .enum(["1", "60", "300", "1200", "3600", "14400", "86400"])
+        .default("60"),
+    filter: z
+        .enum(["average", "max", "min", "sum", "variance"])
+        .default("average"),
+    requestTimeoutMs: z.number().int().positive().default(5000),
+    defaultLookbackMinutes: z.number().int().positive().max(43_200).default(60),
+})
+    .default({});
+export const ConfigSchema = z.object({
+    defaultDatasource: z.string().min(1).optional(),
+    profilesPath: z.string().min(1).optional(),
+    enableMutations: z.boolean().default(true),
+    cloud: CloudSchema,
+    limits: LimitsSchema,
+    audit: AuditSchema,
+    slowSqlSource: z
+        .object({
+        taurusApi: TaurusApiSlowSqlSourceSchema,
+        das: DasSlowSqlSourceSchema,
+    })
+        .default({}),
+    metricsSource: z
+        .object({
+        ces: CesMetricsSourceSchema,
+    })
+        .default({}),
+});

package/dist/context/datasource-resolver.d.ts

@@ -0,0 +1,19 @@
+import type { Config } from "../config/index.js";
+import type { ProfileLoader } from "../auth/sql-profile-loader.js";
+import type { DatasourceResolveInput, DatasourceResolver, SessionContext } from "./session-context.js";
+export declare class DatasourceResolutionError extends Error {
+    readonly code: "DATASOURCE_NOT_FOUND" | "INVALID_CONTEXT_INPUT";
+    constructor(code: "DATASOURCE_NOT_FOUND" | "INVALID_CONTEXT_INPUT", message: string);
+}
+export type DatasourceResolverOptions = {
+    config: Config;
+    profileLoader: ProfileLoader;
+};
+export declare class DefaultDatasourceResolver implements DatasourceResolver {
+    private readonly config;
+    private readonly profileLoader;
+    constructor(options: DatasourceResolverOptions);
+    resolve(input: DatasourceResolveInput, task_id: string): Promise<SessionContext>;
+    private resolveDatasourceName;
+}
+export declare function createDatasourceResolver(options: DatasourceResolverOptions): DatasourceResolver;

package/dist/context/datasource-resolver.js

@@ -0,0 +1,71 @@
+export class DatasourceResolutionError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "DatasourceResolutionError";
+        this.code = code;
+    }
+}
+function normalizeString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function resolveTimeoutMs(requested, fallbackMax) {
+    if (requested === undefined) {
+        return fallbackMax;
+    }
+    if (!Number.isInteger(requested) || requested <= 0) {
+        throw new DatasourceResolutionError("INVALID_CONTEXT_INPUT", `Invalid timeout_ms: ${requested}. It must be a positive integer.`);
+    }
+    return Math.min(requested, fallbackMax);
+}
+export class DefaultDatasourceResolver {
+    config;
+    profileLoader;
+    constructor(options) {
+        this.config = options.config;
+        this.profileLoader = options.profileLoader;
+    }
+    async resolve(input, task_id) {
+        const datasourceName = await this.resolveDatasourceName(input.datasource);
+        const profile = await this.profileLoader.get(datasourceName);
+        if (!profile) {
+            throw new DatasourceResolutionError("DATASOURCE_NOT_FOUND", `Datasource profile "${datasourceName}" was not found.`);
+        }
+        return {
+            task_id,
+            datasource: datasourceName,
+            engine: profile.engine,
+            database: normalizeString(input.database) ?? profile.database,
+            schema: normalizeString(input.schema),
+            limits: {
+                readonly: input.readonly ?? true,
+                timeoutMs: resolveTimeoutMs(input.timeout_ms, this.config.limits.maxStatementMs),
+                maxRows: this.config.limits.maxRows,
+                maxColumns: this.config.limits.maxColumns,
+                maxFieldChars: this.config.limits.maxFieldChars,
+            },
+        };
+    }
+    async resolveDatasourceName(explicitDatasource) {
+        const inputDatasource = normalizeString(explicitDatasource);
+        if (inputDatasource) {
+            return inputDatasource;
+        }
+        if (this.config.defaultDatasource) {
+            return this.config.defaultDatasource;
+        }
+        const loadedDefault = await this.profileLoader.getDefault();
+        const profileDefault = normalizeString(loadedDefault);
+        if (profileDefault) {
+            return profileDefault;
+        }
+        throw new DatasourceResolutionError("DATASOURCE_NOT_FOUND", "No datasource selected. Provide input.datasource or configure a default datasource.");
+    }
+}
+export function createDatasourceResolver(options) {
+    return new DefaultDatasourceResolver(options);
+}

package/dist/context/session-context.d.ts

@@ -0,0 +1,26 @@
+import type { DatabaseEngine } from "../auth/sql-profile-loader.js";
+export interface RuntimeLimits {
+    readonly: boolean;
+    timeoutMs: number;
+    maxRows: number;
+    maxColumns: number;
+    maxFieldChars: number;
+}
+export interface SessionContext {
+    task_id: string;
+    datasource: string;
+    engine: DatabaseEngine;
+    database?: string;
+    schema?: string;
+    limits: RuntimeLimits;
+}
+export interface DatasourceResolveInput {
+    datasource?: string;
+    database?: string;
+    schema?: string;
+    timeout_ms?: number;
+    readonly?: boolean;
+}
+export interface DatasourceResolver {
+    resolve(input: DatasourceResolveInput, task_id: string): Promise<SessionContext>;
+}

package/dist/context/session-context.js

@@ -0,0 +1 @@
+export {};