omnius 1.0.591 → 1.0.592

package/dist/postinstall-daemon.cjs

@@ -39,6 +39,7 @@ var LAUNCHD_LABEL = "ai.omnius.daemon";
 var WIN_TASK_NAME = "OmniusDaemon";
 var REQUIRED_AIWG_VERSION = "2026.5.11";
 var INSTALL_STEPS = 7;
+var DISCOVERY_NOTICE_PRINTED = false;
 
 // ─── Helpers ────────────────────────────────────────────────────────────────
 
@@ -60,6 +61,22 @@ function progress(step, total, msg) {
   process.stdout.write("  [" + "#".repeat(filled) + ".".repeat(width - filled) + "] " + step + "/" + total + " " + msg + "\n");
 }
 
+function printDiscoveryPrimer() {
+  if (DISCOVERY_NOTICE_PRINTED || quietInstall()) return;
+  DISCOVERY_NOTICE_PRINTED = true;
+  process.stdout.write(
+    "\n" +
+    "  Omnius discovery:\n" +
+    "    omnius discover \"bring your own inference\"\n" +
+    "    omnius show tool.web-search\n" +
+    "    omnius docs\n" +
+    "    omnius init\n" +
+    "    http://127.0.0.1:" + PORT + "/help\n" +
+    "    http://127.0.0.1:" + PORT + "/docs\n" +
+    "    http://127.0.0.1:" + PORT + "/openapi.json\n"
+  );
+}
+
 function runQuiet(cmd, opts) {
   try {
     cp.execSync(cmd, Object.assign({ stdio: "pipe", timeout: 15000 }, opts || {}));
@@ -1003,6 +1020,7 @@ function runMainAfterKill() {
 
 function safeExit(code) {
   // Never exit non-zero from postinstall — it breaks `npm i -g`.
+  printDiscoveryPrimer();
   process.exit(typeof code === "number" ? 0 : 0);
 }
 

package/dist/providerRegistry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Canonical inference-provider registry.
+ *
+ * Provider selection is deliberately fail-closed. A URL is usable only when
+ * it matches a known provider, names a provider explicitly, supplies a
+ * protocol explicitly, or carries an unambiguous legacy backend type.
+ */
+export type ProviderProtocol = "ollama" | "openai-chat" | "anthropic-messages";
+export type ProviderAuthStrategy = "none" | "bearer" | "anthropic-api-key";
+export type ProviderCapability = "chat" | "streaming" | "models" | "embeddings" | "tools" | "structured-output";
+export type ProviderPathKind = "chat" | "models" | "embeddings" | "health" | "nativeChat";
+export interface ProviderAuthDescriptor {
+    strategy: ProviderAuthStrategy;
+    required: boolean;
+    keyPrefix?: string;
+    staticHeaders?: Readonly<Record<string, string>>;
+}
+export interface ProviderDescriptor {
+    id: string;
+    aliases: readonly string[];
+    label: string;
+    protocol: ProviderProtocol;
+    local: boolean;
+    apiPrefix: string;
+    paths: Readonly<Partial<Record<ProviderPathKind, string>>>;
+    auth: Readonly<ProviderAuthDescriptor>;
+    capabilities: readonly ProviderCapability[];
+    defaultUrl?: string;
+    apiKeyUrl?: string;
+    docsUrl?: string;
+    description: string;
+}
+export interface ResolveProviderOptions {
+    baseUrl?: string;
+    providerId?: string;
+    protocol?: ProviderProtocol;
+    /**
+     * Compatibility bridge for persisted configurations written before
+     * protocols were first-class. Only deterministic values are accepted.
+     */
+    legacyBackendType?: string;
+}
+export interface ResolvedProviderTransport {
+    descriptor: ProviderDescriptor;
+    providerId: string;
+    protocol: ProviderProtocol;
+    /** Service root before the provider's API prefix. */
+    serviceBaseUrl: string;
+    /** Service root plus the provider's API prefix. */
+    endpointBaseUrl: string;
+    urls: Readonly<Partial<Record<ProviderPathKind, string>>>;
+    source: "known-url" | "provider-id" | "explicit-protocol" | "legacy-backend-type";
+}
+export declare class UnknownProviderProtocolError extends Error {
+    readonly code = "OMNIUS_PROVIDER_PROTOCOL_REQUIRED";
+    constructor(message: string);
+}
+/** Return immutable copies of all known, directly selectable providers. */
+export declare function listProviderDescriptors(): ProviderDescriptor[];
+/** Detect a known provider. Unknown URLs return undefined, never a fallback. */
+export declare function detectProviderDescriptor(rawUrl: string): ProviderDescriptor | undefined;
+/**
+ * Resolve only the provider metadata. Unknown endpoints require an explicit
+ * protocol (or an unambiguous legacy backend type) and otherwise throw.
+ */
+export declare function resolveProviderDescriptor(options: ResolveProviderOptions): ProviderDescriptor;
+/**
+ * Resolve provider metadata and concrete URLs. This function performs no
+ * network requests, so callers can fail before fetch on ambiguous endpoints.
+ */
+export declare function resolveProviderTransport(options: ResolveProviderOptions): ResolvedProviderTransport;
+export interface ProviderHeaderOptions {
+    apiKey?: string;
+    clientVersion?: string;
+    includeJsonContentType?: boolean;
+}
+/** Build provider-correct authentication and client headers. */
+export declare function buildProviderHeaders(provider: ProviderDescriptor | ResolvedProviderTransport, options?: ProviderHeaderOptions): Record<string, string>;
+export declare function providerUrl(provider: ResolvedProviderTransport, kind: ProviderPathKind): string;
+//# sourceMappingURL=providerRegistry.d.ts.map

package/dist/service-version.d.ts

@@ -0,0 +1,35 @@
+export interface ServiceVersionInfo {
+    version: string;
+    package_version: string;
+    boot_version?: string;
+    boot_package_hash?: string | null;
+    api_version?: string;
+    discovery_schema_version?: string;
+    node?: string;
+    platform?: string;
+}
+export declare class OmniusVersionError extends Error {
+    readonly code: "invalid_version" | "stale_runtime" | "invalid_response";
+    readonly installedVersion?: string;
+    readonly minimumVersion?: string;
+    constructor(code: OmniusVersionError["code"], message: string, details?: {
+        installedVersion?: string;
+        minimumVersion?: string;
+    });
+}
+export declare function isVersionGatedExecutionRequest(method: string, pathname: string): boolean;
+interface ParsedVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: string[];
+}
+export declare function parseOmniusVersion(value: string): ParsedVersion | null;
+export declare function compareOmniusVersions(left: string, right: string): number;
+export declare function assertServiceVersion(info: Pick<ServiceVersionInfo, "version" | "package_version">, minimumVersion: string): void;
+export declare function getServiceVersion(baseUrl: string, options?: {
+    apiKey?: string;
+    signal?: AbortSignal;
+}): Promise<ServiceVersionInfo>;
+export {};
+//# sourceMappingURL=service-version.d.ts.map

package/docs/.vitepress/config.mts

@@ -32,6 +32,7 @@ export default defineConfig({
   ],
   themeConfig: {
     nav: [
+      { text: "Discover", link: "/DISCOVERY" },
       { text: "Guide", link: "/getting-started/install" },
       { text: "REST", link: "/reference/rest-api" },
       { text: "Commands", link: "/reference/slash-commands" },
@@ -41,6 +42,7 @@ export default defineConfig({
       {
         text: "Getting Started",
         items: [
+          { text: "Discovery Cascade", link: "/DISCOVERY" },
           { text: "Install", link: "/getting-started/install" },
           { text: "First Run", link: "/getting-started/first-run" },
           { text: "Model Providers", link: "/getting-started/model-providers" },
@@ -49,6 +51,9 @@ export default defineConfig({
       {
         text: "Guides",
         items: [
+          { text: "Bring Your Own Inference", link: "/guides/bring-your-own-inference" },
+          { text: "Tools And Web Search", link: "/guides/tools-and-web-search" },
+          { text: "Agent Integration", link: "/guides/agent-integration" },
           { text: "TUI Workflows", link: "/guides/tui-workflows" },
           { text: "Sponsor And COHERE", link: "/guides/sponsor-and-cohere" },
           { text: "Realtime Conversation", link: "/guides/realtime" },
@@ -63,6 +68,7 @@ export default defineConfig({
           { text: "Quick Reference", link: "/rest/QUICKREF" },
           { text: "Auth And Scopes", link: "/rest/auth-and-scopes" },
           { text: "Errors, Pagination, ETags", link: "/rest/errors-pagination-etags" },
+          { text: "Discovery", link: "/rest/endpoints/discovery" },
           { text: "Chat", link: "/rest/endpoints/chat" },
           { text: "Runs", link: "/rest/endpoints/run" },
           { text: "Config", link: "/rest/endpoints/config" },
@@ -84,6 +90,7 @@ export default defineConfig({
           { text: "REST Inventory", link: "/reference/rest-api" },
           { text: "Slash Commands", link: "/reference/slash-commands" },
           { text: "Configuration", link: "/reference/configuration" },
+          { text: "Authentication Map", link: "/reference/auth-map" },
           { text: "Agent Memory", link: "/agent-memory/" },
         ],
       },
@@ -92,6 +99,7 @@ export default defineConfig({
         items: [
           { text: "Security And Remote Access", link: "/operations/security-and-remote-access" },
           { text: "Runtime Hygiene", link: "/operations/runtime-hygiene" },
+          { text: "Version Compatibility", link: "/operations/version-compatibility" },
         ],
       },
       {