mirror of
https://github.com/hanzoai/ai.git
synced 2026-11-20 14:13:23 +00:00
I invented eight namespaces (rag, chat, content, compute, work, ops, auth,
agents). Three things say that was wrong, and they agree.
The canonical spec in hanzoai/openapi — OpenAPI 3.1, "v1.0.0, locked in,
forward-only, no /api/ prefixes" — states the rule: every route is
/v1/<service>/<resource>. The service here is `ai`. Six of my eight namespaces
are not services at all; they were a second taxonomy competing with a locked one.
/v1/chat/chats stuttered, and the stutter was the tell. A namespace that repeats
its resource is a namespace that is not carrying information.
And /v1/chat was not merely ugly — it was BROKEN. gateway.json routes
GET|POST /v1/chat/{path} to chat.hanzo.svc, a different service, so ai's chats
would have been shadowed at the edge before cloud ever saw them. The same failure
as /v1/iam: a wrong answer, never an error. The foreign-namespace guard now covers
/v1/chat too, with the gateway route named as the reason.
So everything this binary owns lives under /v1/ai/: stores, files, vectors, chats,
messages, providers, routes, templates, videos, articles, tasks, workflows,
records, usages, account, signin, … Forty resources and singletons, one prefix,
no stutter. /v1/router/data keeps its own family (the pre-existing /v1/router/*
config routes are its siblings).
Kept OFF the table deliberately: the OpenAI-compatible surface stays top-level
(/v1/chat/completions, /v1/models, /v1/embeddings) because every OpenAI SDK
hard-codes those paths — the canonical spec calls this out as its one exception,
and the path IS the compatibility contract. The pre-existing RAG operations
(/v1/rag/{embed,query,delete,context}) also stay: they are a live surface chat's
RagClient calls, not resources of mine to rename. A blanket rename caught them
once here; the tests caught it back.
vet clean; the 8 pre-existing failures unchanged.
Co-authored-by: Hanzo Dev <[email protected]>
93 lines
3.5 KiB
Go
93 lines
3.5 KiB
Go
// Copyright 2023-2026 Hanzo AI Inc. All Rights Reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package controllers
|
|
|
|
import (
|
|
"context"
|
|
"net/http"
|
|
"testing"
|
|
)
|
|
|
|
// These pin the reason the fallback exists: the ad-hoc MsgType 200 registry
|
|
// matches on PATH ALONE, which cannot express a RESTful surface. Everything the
|
|
// registry does not claim must reach the real router — with its method and its
|
|
// path parameters intact — or a ZAP caller silently gets the wrong handler.
|
|
|
|
func TestGatewayFallbackCarriesMethodAndPathParams(t *testing.T) {
|
|
var gotMethod, gotPath, gotQuery, gotAuth string
|
|
SetGatewayFallback(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
gotMethod, gotPath, gotQuery = r.Method, r.URL.Path, r.URL.RawQuery
|
|
gotAuth = r.Header.Get("Authorization")
|
|
w.Header().Set("Content-Type", "application/json")
|
|
w.WriteHeader(http.StatusOK)
|
|
_, _ = w.Write([]byte(`{"status":"ok"}`))
|
|
}))
|
|
defer SetGatewayFallback(nil)
|
|
|
|
// A member URL: three things the registry could not have distinguished —
|
|
// the DELETE verb, the two id segments, and the query.
|
|
_, handled, err := serveGatewayViaRouter(context.Background(),
|
|
"DELETE", "/v1/ai/stores/acme/my-store", "force=1", "Bearer t", nil)
|
|
if err != nil {
|
|
t.Fatalf("serve: %v", err)
|
|
}
|
|
if !handled {
|
|
t.Fatal("a request must be handled when a fallback is installed")
|
|
}
|
|
if gotMethod != "DELETE" {
|
|
t.Errorf("method = %q, want DELETE — the verb is lost", gotMethod)
|
|
}
|
|
if gotPath != "/v1/ai/stores/acme/my-store" {
|
|
t.Errorf("path = %q, want the full member path — the id segments are lost", gotPath)
|
|
}
|
|
if gotQuery != "force=1" {
|
|
t.Errorf("query = %q, want force=1", gotQuery)
|
|
}
|
|
if gotAuth != "Bearer t" {
|
|
t.Errorf("auth = %q, want the forwarded credential", gotAuth)
|
|
}
|
|
}
|
|
|
|
// A non-2xx from the router must reach the caller as that status, not be
|
|
// flattened into a generic failure — a 401 has to stay a 401.
|
|
func TestGatewayFallbackPreservesStatus(t *testing.T) {
|
|
SetGatewayFallback(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
w.WriteHeader(http.StatusUnauthorized)
|
|
_, _ = w.Write([]byte(`{"status":"error","msg":"nope"}`))
|
|
}))
|
|
defer SetGatewayFallback(nil)
|
|
|
|
msg, handled, err := serveGatewayViaRouter(context.Background(), "GET", "/v1/ai/stores", "", "", nil)
|
|
if err != nil || !handled || msg == nil {
|
|
t.Fatalf("serve: handled=%v err=%v msg=%v", handled, err, msg)
|
|
}
|
|
if got := msg.Root().Uint32(0); got != http.StatusUnauthorized {
|
|
t.Errorf("status = %d, want 401", got)
|
|
}
|
|
}
|
|
|
|
// With no fallback installed the caller keeps its own 404 — installing the
|
|
// fallback is what turns a miss into a served request, and nothing else changes.
|
|
func TestGatewayFallbackAbsentIsNotHandled(t *testing.T) {
|
|
SetGatewayFallback(nil)
|
|
_, handled, err := serveGatewayViaRouter(context.Background(), "GET", "/v1/ai/stores", "", "", nil)
|
|
if err != nil {
|
|
t.Fatalf("serve: %v", err)
|
|
}
|
|
if handled {
|
|
t.Error("with no fallback installed the request must NOT be reported handled")
|
|
}
|
|
}
|