@mcoda/shared 0.1.101 → 0.1.102

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from "./qa/QaReadiness.js";
 export * from "./qa/QaTechStack.js";
 export * from "./metadata/CommandMetadata.js";
 export * from "./llm/LocalRunnerConfig.js";
+export * from "./llm/GenerativeOperation.js";
 export * from "./mswarm/GenericJobContract.js";
 export * from "./mswarm/CapabilityContract.js";
 export * from "./mswarm/ArtifactSandboxContract.js";

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,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,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,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qCAAqC,CAAC;AACpD,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"}

package/dist/index.js

@@ -7,6 +7,7 @@ export * from "./qa/QaReadiness.js";
 export * from "./qa/QaTechStack.js";
 export * from "./metadata/CommandMetadata.js";
 export * from "./llm/LocalRunnerConfig.js";
+export * from "./llm/GenerativeOperation.js";
 export * from "./mswarm/GenericJobContract.js";
 export * from "./mswarm/CapabilityContract.js";
 export * from "./mswarm/ArtifactSandboxContract.js";

package/dist/llm/GenerativeOperation.d.ts

@@ -0,0 +1,50 @@
+export declare const GENERATIVE_OPERATIONS: readonly ["chat.completions", "images.generations", "audio.generations"];
+export type GenerativeOperation = (typeof GENERATIVE_OPERATIONS)[number];
+export declare const GENERATIVE_MODALITIES: readonly ["text", "image", "audio"];
+export type GenerativeModality = (typeof GENERATIVE_MODALITIES)[number];
+export type GenerativeOperationPath = `/${string}`;
+export type GenerativeOperationMethod = "POST";
+export declare const GENERATIVE_OPERATION_DEFAULT_PATHS: Readonly<Record<GenerativeOperation, GenerativeOperationPath>>;
+export declare const GENERATIVE_REQUEST_PARAMETER_ALLOWLISTS: {
+    readonly "chat.completions": readonly ["model", "messages", "stream", "temperature", "top_p", "max_tokens", "stop", "response_format", "tools", "tool_choice"];
+    readonly "images.generations": readonly ["model", "prompt", "n", "size", "response_format", "seed", "steps", "negative_prompt"];
+    readonly "audio.generations": readonly ["model", "prompt", "duration_seconds", "response_format", "n", "seed", "steps", "negative_prompt", "sample_rate"];
+};
+export type GenerativeRequestParameterByOperation = {
+    [Operation in GenerativeOperation]: (typeof GENERATIVE_REQUEST_PARAMETER_ALLOWLISTS)[Operation][number];
+};
+export type GenerativeRequestParameter<Operation extends GenerativeOperation = GenerativeOperation> = GenerativeRequestParameterByOperation[Operation];
+export type GenerativeRequestParameterAllowlist<Operation extends GenerativeOperation = GenerativeOperation> = readonly GenerativeRequestParameter<Operation>[];
+export declare const GENERATIVE_OPERATION_LIMIT_KEYS: readonly ["maxRequestBytes", "maxOutputBytes", "maxPromptChars", "maxNegativePromptChars", "maxN", "maxWidth", "maxHeight", "maxPixels", "minDurationSeconds", "maxDurationSeconds", "maxSampleRate", "maxSteps"];
+export type GenerativeOperationLimitKey = (typeof GENERATIVE_OPERATION_LIMIT_KEYS)[number];
+export interface GenerativeOperationLimits {
+    maxRequestBytes?: number;
+    maxOutputBytes?: number;
+    maxPromptChars?: number;
+    maxNegativePromptChars?: number;
+    maxN?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    maxPixels?: number;
+    minDurationSeconds?: number;
+    maxDurationSeconds?: number;
+    maxSampleRate?: number;
+    maxSteps?: number;
+}
+export interface SelfHostedGenerativeOperation<Operation extends GenerativeOperation = GenerativeOperation> {
+    operation: Operation;
+    path: GenerativeOperationPath;
+    method?: GenerativeOperationMethod;
+    requestParameterAllowlist?: GenerativeRequestParameterAllowlist<Operation>;
+    responseFormats?: readonly string[];
+    outputMimeTypes?: readonly string[];
+    limits?: GenerativeOperationLimits;
+}
+export type GenerativeOperationDescriptor<Operation extends GenerativeOperation = GenerativeOperation> = SelfHostedGenerativeOperation<Operation>;
+export declare function normalizeGenerativeOperation(value: unknown): GenerativeOperation | undefined;
+export declare function normalizeGenerativeModality(value: unknown): GenerativeModality | undefined;
+export declare function normalizeGenerativeModalities(value: unknown): GenerativeModality[] | undefined;
+export declare function isGenerativeOperationPath(value: unknown): value is GenerativeOperationPath;
+export declare function normalizeGenerativeOperationPath(value: unknown): GenerativeOperationPath | undefined;
+export declare function normalizeSelfHostedGenerativeOperation(value: unknown): SelfHostedGenerativeOperation | undefined;
+//# sourceMappingURL=GenerativeOperation.d.ts.map

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

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

package/dist/llm/GenerativeOperation.js

@@ -0,0 +1,238 @@
+export const GENERATIVE_OPERATIONS = [
+    "chat.completions",
+    "images.generations",
+    "audio.generations",
+];
+export const GENERATIVE_MODALITIES = ["text", "image", "audio"];
+export const GENERATIVE_OPERATION_DEFAULT_PATHS = {
+    "chat.completions": "/v1/chat/completions",
+    "images.generations": "/v1/images/generations",
+    "audio.generations": "/v1/audio/generations",
+};
+export const GENERATIVE_REQUEST_PARAMETER_ALLOWLISTS = {
+    "chat.completions": [
+        "model",
+        "messages",
+        "stream",
+        "temperature",
+        "top_p",
+        "max_tokens",
+        "stop",
+        "response_format",
+        "tools",
+        "tool_choice",
+    ],
+    "images.generations": [
+        "model",
+        "prompt",
+        "n",
+        "size",
+        "response_format",
+        "seed",
+        "steps",
+        "negative_prompt",
+    ],
+    "audio.generations": [
+        "model",
+        "prompt",
+        "duration_seconds",
+        "response_format",
+        "n",
+        "seed",
+        "steps",
+        "negative_prompt",
+        "sample_rate",
+    ],
+};
+export const GENERATIVE_OPERATION_LIMIT_KEYS = [
+    "maxRequestBytes",
+    "maxOutputBytes",
+    "maxPromptChars",
+    "maxNegativePromptChars",
+    "maxN",
+    "maxWidth",
+    "maxHeight",
+    "maxPixels",
+    "minDurationSeconds",
+    "maxDurationSeconds",
+    "maxSampleRate",
+    "maxSteps",
+];
+const OPERATION_ALIASES = {
+    chat: "chat.completions",
+    "chat.completion": "chat.completions",
+    "chat.completions": "chat.completions",
+    "chat-completion": "chat.completions",
+    "chat-completions": "chat.completions",
+    "/v1/chat/completions": "chat.completions",
+    image: "images.generations",
+    images: "images.generations",
+    "image.generation": "images.generations",
+    "image.generations": "images.generations",
+    "images.generation": "images.generations",
+    "images.generations": "images.generations",
+    "image-generation": "images.generations",
+    "image-generations": "images.generations",
+    "/v1/images/generations": "images.generations",
+    audio: "audio.generations",
+    "audio.generation": "audio.generations",
+    "audio.generations": "audio.generations",
+    "audio-generation": "audio.generations",
+    "audio-generations": "audio.generations",
+    "/v1/audio/generations": "audio.generations",
+};
+const MODALITY_ALIASES = {
+    text: "text",
+    chat: "text",
+    image: "image",
+    images: "image",
+    audio: "audio",
+};
+const REQUEST_PARAMETER_SETS = {
+    "chat.completions": new Set(GENERATIVE_REQUEST_PARAMETER_ALLOWLISTS["chat.completions"]),
+    "images.generations": new Set(GENERATIVE_REQUEST_PARAMETER_ALLOWLISTS["images.generations"]),
+    "audio.generations": new Set(GENERATIVE_REQUEST_PARAMETER_ALLOWLISTS["audio.generations"]),
+};
+const LIMIT_KEY_SET = new Set(GENERATIVE_OPERATION_LIMIT_KEYS);
+const STRICT_ORIGIN_RELATIVE_PATH = /^\/[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)*$/;
+const MAX_OPERATION_PATH_LENGTH = 2048;
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const asNormalizedLookupKey = (value) => {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    return normalized.length > 0 ? normalized : undefined;
+};
+export function normalizeGenerativeOperation(value) {
+    const normalized = asNormalizedLookupKey(value);
+    return normalized ? OPERATION_ALIASES[normalized] : undefined;
+}
+export function normalizeGenerativeModality(value) {
+    const normalized = asNormalizedLookupKey(value);
+    return normalized ? MODALITY_ALIASES[normalized] : undefined;
+}
+export function normalizeGenerativeModalities(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const normalized = [];
+    for (const item of value) {
+        const modality = normalizeGenerativeModality(item);
+        if (modality && !normalized.includes(modality)) {
+            normalized.push(modality);
+        }
+    }
+    return normalized.length > 0 ? normalized : undefined;
+}
+export function isGenerativeOperationPath(value) {
+    if (typeof value !== "string"
+        || value.length === 0
+        || value.length > MAX_OPERATION_PATH_LENGTH
+        || value.trim() !== value
+        || !STRICT_ORIGIN_RELATIVE_PATH.test(value)) {
+        return false;
+    }
+    return value
+        .split("/")
+        .slice(1)
+        .every((segment) => segment !== "." && segment !== "..");
+}
+export function normalizeGenerativeOperationPath(value) {
+    return isGenerativeOperationPath(value) ? value : undefined;
+}
+const normalizeRequestParameterAllowlist = (operation, value) => {
+    const defaults = GENERATIVE_REQUEST_PARAMETER_ALLOWLISTS[operation];
+    if (value === undefined) {
+        return [...defaults];
+    }
+    if (!Array.isArray(value))
+        return [];
+    const allowed = REQUEST_PARAMETER_SETS[operation];
+    const normalized = [];
+    for (const item of value) {
+        if (typeof item !== "string")
+            continue;
+        const parameter = item.trim();
+        if (allowed.has(parameter) && !normalized.includes(parameter)) {
+            normalized.push(parameter);
+        }
+    }
+    return normalized;
+};
+const normalizeStringList = (value, normalize) => {
+    if (!Array.isArray(value))
+        return undefined;
+    const normalized = [];
+    for (const item of value) {
+        if (typeof item !== "string")
+            continue;
+        const candidate = normalize(item);
+        if (candidate && !normalized.includes(candidate)) {
+            normalized.push(candidate);
+        }
+    }
+    return normalized;
+};
+const normalizeResponseFormat = (value) => {
+    const normalized = value.trim().toLowerCase();
+    return /^[a-z0-9][a-z0-9._+-]{0,63}$/.test(normalized) ? normalized : undefined;
+};
+const normalizeMimeType = (value) => {
+    const normalized = value.trim().toLowerCase();
+    return /^[a-z0-9][a-z0-9!#$&^_.+-]*\/[a-z0-9][a-z0-9!#$&^_.+-]*$/.test(normalized)
+        ? normalized
+        : undefined;
+};
+const normalizeGenerativeOperationLimits = (value) => {
+    if (!isRecord(value))
+        return undefined;
+    const normalized = {};
+    for (const [key, candidate] of Object.entries(value)) {
+        if (LIMIT_KEY_SET.has(key)
+            && typeof candidate === "number"
+            && Number.isSafeInteger(candidate)
+            && candidate > 0) {
+            normalized[key] = candidate;
+        }
+    }
+    return Object.keys(normalized).length > 0 ? normalized : undefined;
+};
+const normalizeOperationMethod = (value) => {
+    if (value === undefined)
+        return "POST";
+    return typeof value === "string" && value.trim().toUpperCase() === "POST"
+        ? "POST"
+        : undefined;
+};
+export function normalizeSelfHostedGenerativeOperation(value) {
+    const record = isRecord(value) ? value : undefined;
+    const operation = normalizeGenerativeOperation(record ? record.operation : value);
+    if (!operation)
+        return undefined;
+    const method = normalizeOperationMethod(record?.method);
+    if (!method)
+        return undefined;
+    const path = record && record.path !== undefined
+        ? normalizeGenerativeOperationPath(record.path)
+        : GENERATIVE_OPERATION_DEFAULT_PATHS[operation];
+    if (!path)
+        return undefined;
+    const normalized = {
+        operation,
+        path,
+        method,
+        requestParameterAllowlist: normalizeRequestParameterAllowlist(operation, record?.requestParameterAllowlist),
+    };
+    const responseFormats = normalizeStringList(record?.responseFormats, normalizeResponseFormat);
+    if (responseFormats !== undefined) {
+        normalized.responseFormats = responseFormats;
+    }
+    const outputMimeTypes = normalizeStringList(record?.outputMimeTypes, normalizeMimeType);
+    if (outputMimeTypes !== undefined) {
+        normalized.outputMimeTypes = outputMimeTypes;
+    }
+    const limits = normalizeGenerativeOperationLimits(record?.limits);
+    if (limits) {
+        normalized.limits = limits;
+    }
+    return normalized;
+}

package/dist/llm/LocalRunnerConfig.d.ts

@@ -1,10 +1,11 @@
+import { type GenerativeModality, type SelfHostedGenerativeOperation } from "./GenerativeOperation.js";
 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 LocalRunnerKind = "vllm" | "llama-cpp" | "llama-cpp-python" | "stable-diffusion-cpp" | "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;
@@ -12,6 +13,10 @@ export interface LocalOpenAiCompatibleRunnerConfig {
     baseUrl?: string;
     endpoint?: string;
     apiBaseUrl?: string;
+    publicModelId?: string;
+    inputModalities?: GenerativeModality[];
+    outputModalities?: GenerativeModality[];
+    operations?: SelfHostedGenerativeOperation[];
     runnerKind?: LocalRunnerKind;
     authMode?: LocalRunnerAuthMode;
     dummyBearerToken?: string;
@@ -26,7 +31,7 @@ export interface LocalOpenAiCompatibleRunnerConfig {
     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 type LocalRunnerConfigIssueCode = "invalid_auth_mode" | "invalid_runner_kind" | "invalid_response_format_strategy" | "invalid_input_modalities" | "invalid_output_modalities" | "invalid_operations" | "invalid_headers" | "invalid_header_value" | "secret_header" | "invalid_extra_body" | "reserved_extra_body_key";
 export interface LocalRunnerConfigIssue {
     code: LocalRunnerConfigIssueCode;
     path: string;

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

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

package/dist/llm/LocalRunnerConfig.js

@@ -1,3 +1,4 @@
+import { normalizeGenerativeModality, normalizeSelfHostedGenerativeOperation, } from "./GenerativeOperation.js";
 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";
@@ -37,6 +38,11 @@ const RUNNER_KIND_ALIASES = {
     "llama.cpp-python": "llama-cpp-python",
     llamacpppython: "llama-cpp-python",
     "llama_cpp_python": "llama-cpp-python",
+    "stable-diffusion-cpp": "stable-diffusion-cpp",
+    "stable-diffusion.cpp": "stable-diffusion-cpp",
+    stable_diffusion_cpp: "stable-diffusion-cpp",
+    "sd-cpp": "stable-diffusion-cpp",
+    "sd.cpp": "stable-diffusion-cpp",
     "lm-studio": "lm-studio",
     lmstudio: "lm-studio",
     "lm_studio": "lm-studio",
@@ -198,6 +204,84 @@ const normalizeExtraBody = (value, issues) => {
     }
     return Object.keys(extraBody).length > 0 ? extraBody : undefined;
 };
+const normalizeModalityDeclaration = (value, fallback, path, issueCode, issues) => {
+    if (value === undefined)
+        return [...fallback];
+    if (!Array.isArray(value)) {
+        pushIssue(issues, {
+            code: issueCode,
+            path,
+            message: `${path} must be an array of supported generative modalities.`,
+            value,
+        });
+        return [...fallback];
+    }
+    const modalities = [];
+    for (let index = 0; index < value.length; index += 1) {
+        const modality = normalizeGenerativeModality(value[index]);
+        if (!modality) {
+            pushIssue(issues, {
+                code: issueCode,
+                path: `${path}.${index}`,
+                message: "Unknown generative modality.",
+                value: value[index],
+            });
+            continue;
+        }
+        if (!modalities.includes(modality))
+            modalities.push(modality);
+    }
+    return modalities.length > 0 ? modalities : [...fallback];
+};
+const defaultChatOperation = () => {
+    const operation = normalizeSelfHostedGenerativeOperation({
+        operation: "chat.completions",
+    });
+    if (!operation) {
+        throw new Error("Invalid built-in chat.completions operation");
+    }
+    return operation;
+};
+const normalizeOperationDeclarations = (value, issues) => {
+    if (value === undefined)
+        return [defaultChatOperation()];
+    if (!Array.isArray(value)) {
+        pushIssue(issues, {
+            code: "invalid_operations",
+            path: "operations",
+            message: "operations must be an array of supported generative operation descriptors.",
+            value,
+        });
+        return [defaultChatOperation()];
+    }
+    const operations = [];
+    for (let index = 0; index < value.length; index += 1) {
+        const operation = normalizeSelfHostedGenerativeOperation(value[index]);
+        if (!operation) {
+            pushIssue(issues, {
+                code: "invalid_operations",
+                path: `operations.${index}`,
+                message: "Invalid generative operation descriptor.",
+                value: value[index],
+            });
+            continue;
+        }
+        if (!operations.some((entry) => entry.operation === operation.operation)) {
+            operations.push(operation);
+        }
+    }
+    if (operations.length > 0)
+        return operations;
+    if (value.length === 0) {
+        pushIssue(issues, {
+            code: "invalid_operations",
+            path: "operations",
+            message: "operations must declare at least one supported generative operation.",
+            value,
+        });
+    }
+    return [defaultChatOperation()];
+};
 const mergeConfigRecords = (input) => {
     const topLevelConfig = isRecord(input.config) ? input.config : {};
     const nestedAgent = isRecord(topLevelConfig.agent) ? topLevelConfig.agent : {};
@@ -257,6 +341,10 @@ export function normalizeLocalOpenAiCompatibleRunnerConfig(input = {}) {
         baseUrl: readString(merged, ["baseUrl", "endpoint", "apiBaseUrl"]),
         endpoint: readString(merged, ["endpoint"]),
         apiBaseUrl: readString(merged, ["apiBaseUrl"]),
+        publicModelId: readString(merged, ["publicModelId", "public_model_id"]),
+        inputModalities: normalizeModalityDeclaration(merged.inputModalities ?? merged.input_modalities, ["text"], "inputModalities", "invalid_input_modalities", issues),
+        outputModalities: normalizeModalityDeclaration(merged.outputModalities ?? merged.output_modalities, ["text"], "outputModalities", "invalid_output_modalities", issues),
+        operations: normalizeOperationDeclarations(merged.operations, issues),
         runnerKind,
         authMode,
         dummyBearerToken: authMode === "dummy-bearer" ? dummyBearerToken ?? "local" : dummyBearerToken,

package/package.json

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