Files
skills/public/hip-1172.html

291 lines
27 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hip-1172</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/hip-1172.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hip-1172">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hip-1172.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hip-1172</h1><p class="lede">HIP-1172: visor — Compute You Rent. Status Final. Hanzo architectural specification.</p><h1>HIP-1172: visor — Compute You Rent</h1>
<h2>Abstract</h2>
<p>visor is the compute you rent from Hanzo: machines, GPUs and clusters — launch one, resize it, tear it down. It is the tenant&#x27;s own view of that compute on the public API, covering both what Hanzo provisions and what the customer attached, and it fabricates nothing: a GPU row is a real machine&#x27;s accelerator, a cluster is real node pools, and a field the source does not carry is omitted rather than invented. It is implemented in <code>hanzoai/cloud</code> at <code>apps/visor</code> (HIP-0106).</p>
<h2>Motivation</h2>
<p>Renting a machine is the one operation where the price must be knowable before the money moves, so every launch here carries a quote at the same address as the launch. And a fleet is the one inventory a tenant needs answered in a single question rather than four, so the board unions every source the org has — the machines Hanzo runs for it, the boxes it dialled in, its clusters, its agent run targets at <code>/v1/agents/targets</code> — under &quot;what compute do I have, and how hot is it?&quot;. Both are properties an addressed face can have and a scatter of provider calls cannot.</p>
<h2>Specification</h2>
<p>The key words MUST, MUST NOT, SHOULD, SHOULD NOT and MAY are to be interpreted as in RFC 2119.</p>
<h3>§1 It owns no store</h3>
<p>Every row visor answers with is read from something that owns it, and visor persists none of it.</p>
<p>Provisioned compute is the compute service&#x27;s: machines, node pools, the DOKS lifecycle. Attached compute is the per-org registry of bring-your-own clusters (<code>apps/fleet</code>), whose kubeconfigs are sealed in the org&#x27;s KMS (HIP-1134) under a per-org, per-project ref — one registry with two readers, visor and model serving (HIP-1140), and therefore neither one&#x27;s store. Utilization is the shared compute time series (<code>apps/samples</code>), one table in the datastore with <code>org</code> as its only tenant key, bound and never interpolated.</p>
<p>A capability that keeps a private copy of any of the three has two answers to one question. visor keeps none.</p>
<h3>§2 The boundary: the machine, not what runs on it</h3>
<p>visor answers for rented hardware. Everything a customer puts on it belongs somewhere else, and the split is clean at every neighbour:</p>
<ul><li><strong>platform</strong> (HIP-1230) is the container plane: builds, releases,</li></ul>
<p> environments, domains, logs. &quot;Give me a GPU box&quot; is visor; &quot;run this image&quot; is platform. Neither provisions the other&#x27;s noun.</p>
<ul><li><strong>sandboxes</strong> (HIP-1146) is the compute primitive for somebody else&#x27;s code —</li></ul>
<p> a pod whose lifetime is a request, on capacity that already exists. visor never executes a customer&#x27;s code; it hands back a machine and stops.</p>
<ul><li><strong>bot</strong> owns <code>/v1/bot/runs</code>, which is a bot doing work on a desktop, live: a</li></ul>
<p> session. <code>/v1/visor/compute/bots</code> is a machine of kind bot plus its agent binding — rented hardware bootstrapped with a runtime. Two nouns share a word and do not share an address.</p>
<ul><li><strong>agents</strong> (HIP-1210) owns the agent. visor owns the binding that says a given</li></ul>
<p> machine hosts one, because the binding is a property of the machine.</p>
<p>Inside visor, <code>/v1/visor/clusters</code> is the fleet&#x27;s answer to &quot;what clusters do I have&quot;, provisioned and attached together, while <code>/v1/visor/k8s</code> is the provider lifecycle that creates and destroys them. Both are visor&#x27;s, which is exactly why they fold under one name rather than being called two capabilities.</p>
<h3>§3 The addresses</h3>
<p>visor answers under <code>/v1/visor</code>, the one root HIP-0139 §3 gives a capability (<code>manifest/apps.go:309</code>), and every noun of the compute plane is one segment down (<code>apps/visor/visor.go:143-268</code>). The six top-level roots those nouns used to sit at — <code>/v1/machines</code>, <code>/v1/gpus</code>, <code>/v1/clusters</code>, <code>/v1/k8s</code>, <code>/v1/fleet</code> and <code>/v1/compute</code> — were six lines of the misfiled ratchet (HIP-0139 §5.1), and all six closed by fold (HIP-0139 §7.1), never by split: there is one owner and §1 leaves no second store to split along. No alias was left behind, so an address that begins anywhere else is not visor&#x27;s.</p>
<ul><li><code>/v1/visor/machines</code> — the org&#x27;s machines, one machine, its agent binding, and</li></ul>
<p> every binding in the fleet at <code>/v1/visor/machines/agents</code>.</p>
<ul><li><code>/v1/visor/gpus</code> — the accelerators on those machines, and</li></ul>
<p> <code>/v1/visor/gpus/alerts</code>.</p>
<ul><li><code>/v1/visor/clusters</code> — the cluster list, attach and detach, and node-pool</li></ul>
<p> create, scale and delete.</p>
<ul><li><code>/v1/visor/k8s</code> — cluster list, one cluster with its pools and worker nodes,</li></ul>
<p> create, delete, and the fleet-wide worker nodes at <code>/v1/visor/k8s/nodes</code>.</p>
<ul><li><code>/v1/visor/fleet</code> — the board, the attached workers at</li></ul>
<p> <code>/v1/visor/fleet/workers</code>, the utilization series at <code>/v1/visor/fleet/samples</code>, and the GPU job queue at <code>/v1/visor/fleet/jobs</code> with a cancel.</p>
<ul><li><code>/v1/visor/compute</code> — the launch catalog at <code>/v1/visor/compute/regions</code> and</li></ul>
<p> <code>/v1/visor/compute/sizes</code>, and bot machines under <code>/v1/visor/compute/bots</code>.</p>
<p>Every route with a shape to state is typed. Five are declared with prose beside the route, and each names why it cannot be a value:</p>
<ol><li><code>POST /v1/visor/machines</code> and <code>POST /v1/visor/compute/bots/launch</code> — the</li></ol>
<p> response shape is chosen by the request: <code>dryRun</code> answers 200 with a price quote, a real launch answers 201 with the created resource. A typed op declares one <code>Out</code>, so typing either would have to change one of the two bodies.</p>
<ol><li><code>GET /v1/visor/compute/regions</code> and <code>GET /v1/visor/compute/sizes</code> — the body</li></ol>
<p> is the launch catalog exactly as the compute service states it. visor does not know that shape, and inventing one is the opposite of what a passthrough is for.</p>
<ol><li><code>POST /v1/visor/compute/bots/{id}/{action}</code> — a verb dispatch, not a</li></ol>
<p> resource. The <code>message</code> action streams the bound agent&#x27;s answer back untouched: the upstream body, its content type and its status. There is no <code>Out</code>, and declaring one would buffer the stream.</p>
<p>The two launches spend real money, so their prose MUST state where the quote is; a caller reading only the document has no other place to learn it.</p>
<p>The address visor serves is not the address it dials. The compute service keeps its own spelling one segment apart — <code>/v1/machines</code>, <code>/v1/machines/launch</code>, <code>/v1/k8s/clusters</code>, <code>/v1/k8s/nodes</code> and their siblings on <code>visor.hanzo.svc</code> — and those literals are the wire, so they did not move with the fold (<code>apps/visor/client.go</code>). In this package a <code>cl.call</code> or <code>cl.op</code> path is upstream&#x27;s and a <code>zip.Get(reg, …)</code> path is ours; the two are read apart by which one holds them, never by resemblance.</p>
<h3>§4 Tenancy</h3>
<p>The tenant is <code>principal.Org</code>, minted from the validated IAM owner claim (HIP-0026). It is forwarded to the compute service as <code>owner=&lt;org&gt;</code>, beside the gateway&#x27;s own identity headers, which the edge has already sanitized of any client copy. It is never read from a body: a launch always lands in the caller&#x27;s own tenant, and the ownership field a request might carry is ignored, not honoured. Absent a validated principal the answer is 403.</p>
<p>A machine is addressed upstream as owner plus name, so another tenant&#x27;s id is not reachable rather than refused — the surface is not an existence oracle. Reads are open to any validated member of the org. The two mutations on <code>/v1/visor/k8s/clusters</code>, create and delete, additionally require a platform SuperAdmin or an admin of the caller&#x27;s own org (<code>requireClusterAdmin</code>, HIP-0118), because provisioning spends on the house account rather than the customer&#x27;s.</p>
<h3>§5 Money</h3>
<p>The surface declares <code>cloud.Metered</code> (<code>plugin/visor/main.go</code>).</p>
<p>A launch is not metered here. It fronts the compute service&#x27;s resell endpoint, which owns the balance gate and the per-hour meter; visor forwards the tenant and returns what came back, and a <code>dryRun</code> quote is that service&#x27;s price verbatim. Putting a second meter on this plane would be a second number for one machine.</p>
<p>visor meters exactly one unit of its own: attaching a bring-your-own cluster, kind <code>byo-cluster</code>, priced from the shared compute fee (<code>CLOUD_COMPUTE_FEE_CENTS</code>, whose source is the price list, HIP-1222). The customer brings the compute and the management plane is what is charged. The debit lands through the org&#x27;s resource meter under the provider label <code>compute</code> — the commerce attribution and spend-cap scope key — and is gated before the register and metered after it, on the same key, so the amount authorized and the amount charged cannot drift. A deployment that prices the attach at zero is ungated exactly as it is unbilled. Every other route is free.</p>
<h3>§6 Events and observability</h3>
<p>visor publishes nothing on the bus: no <code>visor.*</code> event reaches a customer&#x27;s webhooks. Beyond the request span every route already gets, it writes no audit record and exports no metric of its own.</p>
<p>What it does emit is the tenant&#x27;s own data, on request. <code>POST /v1/visor/fleet/samples</code> is how an attached worker self-reports utilization; the sample is validated against the closed source and unit vocabularies, stamped with the caller&#x27;s org, and appended to the shared series off the request path, so a slow or absent warehouse never fails an ingest. <code>GET /v1/visor/fleet/samples</code> reads that series back and <code>GET /v1/visor/fleet</code> folds the latest sample onto each unit.</p>
<h3>§7 A partial answer says it is partial</h3>
<p>Several reads here fold two independent sources, and a fold that loses one MUST still answer with the source that replied. An outage in a provider a tenant does not use must not take away the box the tenant does own.</p>
<p>The fold therefore carries the failure rather than swallowing it: a <code>degraded</code> list names the source that did not answer and gives a terse, log-safe reason — never the upstream&#x27;s body, which for an unknown path is a page of markup. The field is additive and omitted when everything answered, so a healthy response is unchanged and a consumer that wants to tell an outage from an empty estate can. Without it, &quot;the provider is down&quot; and &quot;you own nothing&quot; are the same three bytes on the wire.</p>
<h3>§8 Stage</h3>
<p><code>ga</code>. The manifest row declares no stage, and absent is <code>ga</code> (HIP-0139 §8).</p>
<h3>§9 Upstream</h3>
<p>The capability derives from no upstream code: <code>apps/visor</code> embeds nothing and holds one HTTP client. The compute service it fronts is <code>hanzoai/visor</code>, Apache-2.0, which derives from Casbin&#x27;s Casibase with that notice preserved in its LICENSE.</p>
<p>That client speaks two wires and every call site says which, because they cannot be told apart by looking. The enveloped wire answers HTTP 200 with <code>{status, msg, data}</code>, so a logical failure is <code>status: &quot;error&quot;</code> at 200 and a bare status check reads it as success. The typed wire answers the value: the status is the outcome, 204 for a void result and 404 for a miss, with no envelope. Converting a noun from one to the other is a wire break and lands with its caller in the same change.</p>
<h2>Rationale</h2>
<p>The alternative to one face over a compute service is the console and the CLI each calling that service directly. It costs a second copy of the tenant rule in every client, and the tenant rule is the whole security model here. The alternative to folding attached compute into the same lists is a second cluster surface for bring-your-own, which answers &quot;what clusters do I have&quot; twice and eventually differently.</p>
<h2>Security Considerations</h2>
<p>The wrong implementation hands one tenant another tenant&#x27;s compute. Three facts prevent it and none of them takes an input the caller controls: the owner is the validated claim, so a launch cannot be addressed elsewhere; a machine is identified upstream as owner plus name, so another tenant&#x27;s id resolves to not-found rather than to a refusal that confirms it exists; and the identity headers forwarded are the gateway&#x27;s own, the client&#x27;s having been dropped at the edge.</p>
<p>The attach is the sharpest edge, because a kubeconfig is both a credential for a cluster and an instruction to dial a host. It is validated before it is sealed, at the one check that discovery folds and hand-pasted attaches both pass through: an <code>exec</code> or auth-provider credential plugin is refused, because honouring one runs a binary in the serving process&#x27;s environment, and the apiserver must be a routable https endpoint, because a private address is a request to dial inside the cluster. What is stored is sealed in the org&#x27;s KMS, so the custody nodes hold ciphertext, and it is never echoed back.</p>
<p>The admin gate on cluster create and delete protects Hanzo&#x27;s own money rather than the tenant&#x27;s data, which is why it is the only mutation here that asks for more than membership.</p>
<h2>References</h2>
<ul><li>HIP-0026 — Identity and Access Management</li><li>HIP-0106 — Hanzo Plugin Contract</li><li>HIP-0118 — SuperAdmin and Tenant Isolation</li><li>HIP-0139 — Capability</li><li>HIP-1134 — KMS — Secret Custody</li><li>HIP-1140 — ML — Model Serving</li><li>HIP-1146 — Sandboxes — The Compute Primitive</li><li>HIP-1210 — Agents — Define, Run, Keep the Run</li><li>HIP-1222 — Pricing — The Price List and Who May See It</li><li>HIP-1230 — Platform — The Container Plane</li></ul>
<h2>Copyright</h2>
<p>Released under CC0 1.0 Universal Public Domain Dedication.</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hip-1172.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>