@mcoda/shared 0.1.71 → 0.1.73

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from "./qa/QaPlan.js";
 export * from "./qa/QaReadiness.js";
 export * from "./qa/QaTechStack.js";
 export * from "./metadata/CommandMetadata.js";
+export * from "./llm/LocalRunnerConfig.js";
 export * from "./status/TaskStatus.js";
 export type { BacklogLaneTotals, BacklogTotals, BacklogSummary, EffectiveVelocity, EstimateResult, EstimateDurations, EstimateEtas, EstimateStatusCounts, EstimateCompletionMetric, EstimateCompletion, VelocitySource, AgentHealth, AgentHealthStatus, AgentUsageLimitScope, AgentUsageLimitWindowType, AgentUsageLimitStatus, AgentUsageLimitRecord, UpsertAgentUsageLimitInput, RoutingDefaults, RoutingDefault, RoutingProvenance, RoutingCandidate, RoutingPreview, RoutingDefaultsUpdate, RefineTasksRequest, RefineTasksPlan, RefineTasksResult, RefineStrategy, RefineOperation, UpdateTaskOp, SplitTaskOp, MergeTasksOp, UpdateEstimateOp, UpdateInfo, UpdateChannel, ApplyUpdateResponse, } from "./openapi/OpenApiTypes.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -6,4 +6,5 @@ export * from "./qa/QaPlan.js";
 export * from "./qa/QaReadiness.js";
 export * from "./qa/QaTechStack.js";
 export * from "./metadata/CommandMetadata.js";
+export * from "./llm/LocalRunnerConfig.js";
 export * from "./status/TaskStatus.js";

package/dist/llm/LocalRunnerConfig.d.ts

@@ -0,0 +1,61 @@
+export declare const LOCAL_OPENAI_COMPATIBLE_ADAPTER: "openai-compatible-local";
+export declare const VLLM_LOCAL_ADAPTER: "vllm-local";
+export declare const LLAMA_CPP_LOCAL_ADAPTER: "llama-cpp-local";
+export declare const LEGACY_LLAMACPP_LOCAL_ADAPTER: "llamacpp-local";
+export declare const LOCAL_OPENAI_COMPATIBLE_ADAPTER_ALIASES: readonly ["openai-compatible-local", "vllm-local", "llama-cpp-local", "llamacpp-local"];
+export type LocalOpenAiCompatibleAdapter = (typeof LOCAL_OPENAI_COMPATIBLE_ADAPTER_ALIASES)[number];
+export type LocalRunnerKind = "vllm" | "llama-cpp" | "llama-cpp-python" | "lm-studio" | "localai" | "sglang" | "tgi" | "custom";
+export type LocalRunnerAuthMode = "none" | "bearer" | "dummy-bearer";
+export type LocalRunnerResponseFormatStrategy = "openai" | "json-object" | "json-schema" | "gbnf" | "prompt-only" | "none";
+export type ResponseFormatStrategy = LocalRunnerResponseFormatStrategy;
+export interface LocalOpenAiCompatibleRunnerConfig {
+    baseUrl?: string;
+    endpoint?: string;
+    apiBaseUrl?: string;
+    runnerKind?: LocalRunnerKind;
+    authMode?: LocalRunnerAuthMode;
+    dummyBearerToken?: string;
+    headers?: Record<string, string>;
+    extraBody?: Record<string, unknown>;
+    responseFormatStrategy?: LocalRunnerResponseFormatStrategy;
+    healthPath?: string;
+    modelsPath?: string;
+    requireModelInRequest?: boolean;
+    supportsStreaming?: boolean;
+    supportsTools?: boolean;
+    supportsJsonSchema?: boolean;
+    supportsGbnf?: boolean;
+}
+export type LocalRunnerConfigIssueCode = "invalid_auth_mode" | "invalid_runner_kind" | "invalid_response_format_strategy" | "invalid_headers" | "invalid_header_value" | "secret_header" | "invalid_extra_body" | "reserved_extra_body_key";
+export interface LocalRunnerConfigIssue {
+    code: LocalRunnerConfigIssueCode;
+    path: string;
+    message: string;
+    value?: unknown;
+}
+export interface LocalRunnerNormalizationInput {
+    adapter?: unknown;
+    config?: unknown;
+    agentConfig?: unknown;
+    defaultRunnerKind?: unknown;
+}
+export interface NormalizedLocalOpenAiCompatibleRunnerConfig {
+    adapter?: typeof LOCAL_OPENAI_COMPATIBLE_ADAPTER;
+    originalAdapter?: string;
+    isLocalOpenAiCompatible: boolean;
+    config: LocalOpenAiCompatibleRunnerConfig;
+    issues: LocalRunnerConfigIssue[];
+}
+export declare const LOCAL_RUNNER_SECRET_HEADER_KEYS: readonly ["authorization", "proxy-authorization", "x-api-key", "api-key"];
+export declare const LOCAL_RUNNER_RESERVED_EXTRA_BODY_KEYS: readonly ["model", "messages", "stream", "tools", "tool_choice", "response_format", "max_tokens", "temperature"];
+export declare function isLocalOpenAiCompatibleAdapter(adapter: unknown): boolean;
+export declare function normalizeLocalOpenAiCompatibleAdapter(adapter: unknown): typeof LOCAL_OPENAI_COMPATIBLE_ADAPTER | undefined;
+export declare function defaultLocalRunnerKindForAdapter(adapter: unknown): LocalRunnerKind | undefined;
+export declare function normalizeLocalRunnerKind(value: unknown): LocalRunnerKind | undefined;
+export declare function normalizeLocalRunnerAuthMode(value: unknown): LocalRunnerAuthMode | undefined;
+export declare function normalizeLocalRunnerResponseFormatStrategy(value: unknown): LocalRunnerResponseFormatStrategy | undefined;
+export declare function isSecretLocalRunnerHeaderKey(key: string): boolean;
+export declare function isReservedLocalRunnerExtraBodyKey(key: string): boolean;
+export declare function normalizeLocalOpenAiCompatibleRunnerConfig(input?: LocalRunnerNormalizationInput): NormalizedLocalOpenAiCompatibleRunnerConfig;
+export declare function validateLocalOpenAiCompatibleRunnerConfig(config: LocalOpenAiCompatibleRunnerConfig): LocalRunnerConfigIssue[];
+//# sourceMappingURL=LocalRunnerConfig.d.ts.map

package/dist/llm/LocalRunnerConfig.d.ts.map

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

package/dist/llm/LocalRunnerConfig.js

@@ -0,0 +1,287 @@
+export const LOCAL_OPENAI_COMPATIBLE_ADAPTER = "openai-compatible-local";
+export const VLLM_LOCAL_ADAPTER = "vllm-local";
+export const LLAMA_CPP_LOCAL_ADAPTER = "llama-cpp-local";
+export const LEGACY_LLAMACPP_LOCAL_ADAPTER = "llamacpp-local";
+export const LOCAL_OPENAI_COMPATIBLE_ADAPTER_ALIASES = [
+    LOCAL_OPENAI_COMPATIBLE_ADAPTER,
+    VLLM_LOCAL_ADAPTER,
+    LLAMA_CPP_LOCAL_ADAPTER,
+    LEGACY_LLAMACPP_LOCAL_ADAPTER,
+];
+export const LOCAL_RUNNER_SECRET_HEADER_KEYS = [
+    "authorization",
+    "proxy-authorization",
+    "x-api-key",
+    "api-key",
+];
+export const LOCAL_RUNNER_RESERVED_EXTRA_BODY_KEYS = [
+    "model",
+    "messages",
+    "stream",
+    "tools",
+    "tool_choice",
+    "response_format",
+    "max_tokens",
+    "temperature",
+];
+const LOCAL_OPENAI_COMPATIBLE_ADAPTER_SET = new Set(LOCAL_OPENAI_COMPATIBLE_ADAPTER_ALIASES);
+const SECRET_HEADER_SET = new Set(LOCAL_RUNNER_SECRET_HEADER_KEYS);
+const RESERVED_EXTRA_BODY_KEY_SET = new Set(LOCAL_RUNNER_RESERVED_EXTRA_BODY_KEYS);
+const RUNNER_KIND_ALIASES = {
+    vllm: "vllm",
+    "llama-cpp": "llama-cpp",
+    "llama.cpp": "llama-cpp",
+    llamacpp: "llama-cpp",
+    "llama_cpp": "llama-cpp",
+    "llama-cpp-python": "llama-cpp-python",
+    "llama.cpp-python": "llama-cpp-python",
+    llamacpppython: "llama-cpp-python",
+    "llama_cpp_python": "llama-cpp-python",
+    "lm-studio": "lm-studio",
+    lmstudio: "lm-studio",
+    "lm_studio": "lm-studio",
+    localai: "localai",
+    "local-ai": "localai",
+    local_ai: "localai",
+    sglang: "sglang",
+    tgi: "tgi",
+    "text-generation-inference": "tgi",
+    text_generation_inference: "tgi",
+    custom: "custom",
+};
+const AUTH_MODE_ALIASES = {
+    none: "none",
+    bearer: "bearer",
+    "dummy-bearer": "dummy-bearer",
+    dummy_bearer: "dummy-bearer",
+    dummybearer: "dummy-bearer",
+    dummy: "dummy-bearer",
+};
+const RESPONSE_FORMAT_STRATEGY_ALIASES = {
+    openai: "openai",
+    "json-object": "json-object",
+    json_object: "json-object",
+    jsonobject: "json-object",
+    "json-schema": "json-schema",
+    json_schema: "json-schema",
+    jsonschema: "json-schema",
+    gbnf: "gbnf",
+    "prompt-only": "prompt-only",
+    prompt_only: "prompt-only",
+    promptonly: "prompt-only",
+    none: "none",
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const asString = (value) => {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+const asBoolean = (value) => typeof value === "boolean" ? value : undefined;
+const normalizeLookupKey = (value) => value.trim().toLowerCase();
+const readString = (record, keys) => {
+    for (const key of keys) {
+        const value = asString(record[key]);
+        if (value)
+            return value;
+    }
+    return undefined;
+};
+const pushIssue = (issues, issue) => {
+    issues.push(issue);
+};
+export function isLocalOpenAiCompatibleAdapter(adapter) {
+    const normalized = asString(adapter);
+    return normalized ? LOCAL_OPENAI_COMPATIBLE_ADAPTER_SET.has(normalizeLookupKey(normalized)) : false;
+}
+export function normalizeLocalOpenAiCompatibleAdapter(adapter) {
+    return isLocalOpenAiCompatibleAdapter(adapter) ? LOCAL_OPENAI_COMPATIBLE_ADAPTER : undefined;
+}
+export function defaultLocalRunnerKindForAdapter(adapter) {
+    const normalized = asString(adapter);
+    if (!normalized)
+        return undefined;
+    const lookupKey = normalizeLookupKey(normalized);
+    if (lookupKey === VLLM_LOCAL_ADAPTER)
+        return "vllm";
+    if (lookupKey === LLAMA_CPP_LOCAL_ADAPTER || lookupKey === LEGACY_LLAMACPP_LOCAL_ADAPTER) {
+        return "llama-cpp";
+    }
+    return undefined;
+}
+export function normalizeLocalRunnerKind(value) {
+    const normalized = asString(value);
+    if (!normalized)
+        return undefined;
+    return RUNNER_KIND_ALIASES[normalizeLookupKey(normalized)];
+}
+export function normalizeLocalRunnerAuthMode(value) {
+    const normalized = asString(value);
+    if (!normalized)
+        return undefined;
+    return AUTH_MODE_ALIASES[normalizeLookupKey(normalized)];
+}
+export function normalizeLocalRunnerResponseFormatStrategy(value) {
+    const normalized = asString(value);
+    if (!normalized)
+        return undefined;
+    return RESPONSE_FORMAT_STRATEGY_ALIASES[normalizeLookupKey(normalized)];
+}
+export function isSecretLocalRunnerHeaderKey(key) {
+    return SECRET_HEADER_SET.has(normalizeLookupKey(key));
+}
+export function isReservedLocalRunnerExtraBodyKey(key) {
+    return RESERVED_EXTRA_BODY_KEY_SET.has(normalizeLookupKey(key));
+}
+const normalizeHeaders = (value, issues) => {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        pushIssue(issues, {
+            code: "invalid_headers",
+            path: "headers",
+            message: "Local runner headers must be an object with string values.",
+            value,
+        });
+        return undefined;
+    }
+    const headers = {};
+    for (const [key, headerValue] of Object.entries(value)) {
+        const stringValue = asString(headerValue);
+        if (!stringValue) {
+            pushIssue(issues, {
+                code: "invalid_header_value",
+                path: `headers.${key}`,
+                message: "Local runner header values must be non-empty strings.",
+                value: headerValue,
+            });
+            continue;
+        }
+        if (isSecretLocalRunnerHeaderKey(key)) {
+            pushIssue(issues, {
+                code: "secret_header",
+                path: `headers.${key}`,
+                message: "Secret-bearing headers must not be stored in local runner config.",
+                value: key,
+            });
+            continue;
+        }
+        headers[key] = stringValue;
+    }
+    return Object.keys(headers).length > 0 ? headers : undefined;
+};
+const normalizeExtraBody = (value, issues) => {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        pushIssue(issues, {
+            code: "invalid_extra_body",
+            path: "extraBody",
+            message: "Local runner extraBody must be an object.",
+            value,
+        });
+        return undefined;
+    }
+    const extraBody = {};
+    for (const [key, entryValue] of Object.entries(value)) {
+        if (isReservedLocalRunnerExtraBodyKey(key)) {
+            pushIssue(issues, {
+                code: "reserved_extra_body_key",
+                path: `extraBody.${key}`,
+                message: "extraBody must not override core OpenAI-compatible request fields.",
+                value: key,
+            });
+            continue;
+        }
+        extraBody[key] = entryValue;
+    }
+    return Object.keys(extraBody).length > 0 ? extraBody : undefined;
+};
+const mergeConfigRecords = (input) => {
+    const topLevelConfig = isRecord(input.config) ? input.config : {};
+    const nestedAgent = isRecord(topLevelConfig.agent) ? topLevelConfig.agent : {};
+    const nestedAgentConfig = isRecord(nestedAgent.config) ? nestedAgent.config : {};
+    const explicitAgentConfig = isRecord(input.agentConfig) ? input.agentConfig : {};
+    const localRunnerConfig = isRecord(topLevelConfig.localRunner) ? topLevelConfig.localRunner : {};
+    return {
+        ...nestedAgentConfig,
+        ...explicitAgentConfig,
+        ...localRunnerConfig,
+        ...topLevelConfig,
+    };
+};
+export function normalizeLocalOpenAiCompatibleRunnerConfig(input = {}) {
+    const issues = [];
+    const merged = mergeConfigRecords(input);
+    const nestedAgent = isRecord(merged.agent) ? merged.agent : {};
+    const originalAdapter = asString(input.adapter) ?? asString(merged.adapter) ?? asString(nestedAgent.adapter);
+    const adapter = normalizeLocalOpenAiCompatibleAdapter(originalAdapter);
+    const isLocalOpenAiCompatible = adapter !== undefined;
+    const rawRunnerKind = merged.runnerKind;
+    const normalizedRunnerKind = normalizeLocalRunnerKind(rawRunnerKind);
+    const runnerKind = normalizedRunnerKind ??
+        normalizeLocalRunnerKind(input.defaultRunnerKind) ??
+        defaultLocalRunnerKindForAdapter(originalAdapter);
+    if (rawRunnerKind !== undefined && normalizedRunnerKind === undefined) {
+        pushIssue(issues, {
+            code: "invalid_runner_kind",
+            path: "runnerKind",
+            message: "Unknown local runner kind.",
+            value: rawRunnerKind,
+        });
+    }
+    const rawAuthMode = merged.authMode;
+    const authMode = normalizeLocalRunnerAuthMode(rawAuthMode) ?? (isLocalOpenAiCompatible ? "none" : undefined);
+    if (rawAuthMode !== undefined && normalizeLocalRunnerAuthMode(rawAuthMode) === undefined) {
+        pushIssue(issues, {
+            code: "invalid_auth_mode",
+            path: "authMode",
+            message: "Unknown local runner auth mode.",
+            value: rawAuthMode,
+        });
+    }
+    const rawResponseFormatStrategy = merged.responseFormatStrategy;
+    const responseFormatStrategy = normalizeLocalRunnerResponseFormatStrategy(rawResponseFormatStrategy);
+    if (rawResponseFormatStrategy !== undefined &&
+        normalizeLocalRunnerResponseFormatStrategy(rawResponseFormatStrategy) === undefined) {
+        pushIssue(issues, {
+            code: "invalid_response_format_strategy",
+            path: "responseFormatStrategy",
+            message: "Unknown local runner response format strategy.",
+            value: rawResponseFormatStrategy,
+        });
+    }
+    const dummyBearerToken = readString(merged, ["dummyBearerToken", "dummyApiKey"]);
+    const config = {
+        baseUrl: readString(merged, ["baseUrl", "endpoint", "apiBaseUrl"]),
+        endpoint: readString(merged, ["endpoint"]),
+        apiBaseUrl: readString(merged, ["apiBaseUrl"]),
+        runnerKind,
+        authMode,
+        dummyBearerToken: authMode === "dummy-bearer" ? dummyBearerToken ?? "local" : dummyBearerToken,
+        headers: normalizeHeaders(merged.headers, issues),
+        extraBody: normalizeExtraBody(merged.extraBody, issues),
+        responseFormatStrategy,
+        healthPath: readString(merged, ["healthPath"]),
+        modelsPath: readString(merged, ["modelsPath"]),
+        requireModelInRequest: asBoolean(merged.requireModelInRequest),
+        supportsStreaming: asBoolean(merged.supportsStreaming),
+        supportsTools: asBoolean(merged.supportsTools),
+        supportsJsonSchema: asBoolean(merged.supportsJsonSchema),
+        supportsGbnf: asBoolean(merged.supportsGbnf),
+    };
+    return {
+        adapter,
+        originalAdapter,
+        isLocalOpenAiCompatible,
+        config,
+        issues,
+    };
+}
+export function validateLocalOpenAiCompatibleRunnerConfig(config) {
+    return normalizeLocalOpenAiCompatibleRunnerConfig({
+        adapter: LOCAL_OPENAI_COMPATIBLE_ADAPTER,
+        config,
+    }).issues;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcoda/shared",
-  "version": "0.1.71",
+  "version": "0.1.73",
   "description": "Shared utilities and schemas for mcoda.",
   "type": "module",
   "main": "dist/index.js",