@elevasis/sdk 1.44.2 → 1.45.0

package/reference/scaffold/ui/recipes.md

@@ -1,61 +1,62 @@
----
-title: UI Recipes
-description: Current recipes for adding pages, system-gated routes, system components, theme tokens, Organization Model sidebar entries, and executable resources.
----
+---
+title: UI Recipes
+description: Current recipes for adding pages, system-gated routes, system components, theme tokens, Organization Model sidebar entries, and executable resources.
+---
 <!-- @generated by packages/sdk/scripts/copy-reference-docs.mjs -- DO NOT EDIT -->
 <!-- Regenerate: pnpm scaffold:sync -->
 
-
-# UI Recipes
-
-## 1. Add a Top-Level Page
-
-Create `ui/src/routes/my-system.index.tsx`:
-
-```tsx
-import { createFileRoute } from '@tanstack/react-router'
-import { ProtectedRoute } from '@/features/auth'
-import { AppShellContentContainer, AppTopbarAdjusterWrapper, PageContainer } from '@elevasis/ui/layout'
-import { MySystemPage } from '@/features/my-system/components/MySystemPage'
-
-export const Route = createFileRoute('/my-system/')({
-  component: MySystemRouteComponent
-})
-
-function MySystemRouteComponent() {
-  return (
-    <ProtectedRoute>
-      <AppTopbarAdjusterWrapper>
-        <AppShellContentContainer>
-          <PageContainer>
-            <MySystemPage />
-          </PageContainer>
-        </AppShellContentContainer>
-      </AppTopbarAdjusterWrapper>
-    </ProtectedRoute>
-  )
-}
-```
-
-Add the sidebar entry as a system node in `core/config/organization-model.ts`:
-
-```ts
-systems: {
-  systems: [
-  {
-    id: 'my-system',
-    label: 'My System',
-    enabled: true,
-    path: '/my-system',
-    icon: 'star',
-    uiPosition: 'sidebar-primary'
-  }
-  ]
-}
-```
-
-TanStack Router derives the path from the filename. The sidebar is derived from `OrganizationModel.systems`.
-
+
+# UI Recipes
+
+## 1. Add a Top-Level Page
+
+Create `ui/src/routes/my-system.index.tsx`:
+
+```tsx
+import { createFileRoute } from '@tanstack/react-router'
+import { ProtectedRoute } from '@/features/auth'
+import { AppShellContentContainer, AppTopbarAdjusterWrapper, PageContainer } from '@elevasis/ui/layout'
+import { MySystemPage } from '@/features/my-system/components/MySystemPage'
+
+export const Route = createFileRoute('/my-system/')({
+  component: MySystemRouteComponent
+})
+
+function MySystemRouteComponent() {
+  return (
+    <ProtectedRoute>
+      <AppTopbarAdjusterWrapper>
+        <AppShellContentContainer>
+          <PageContainer>
+            <MySystemPage />
+          </PageContainer>
+        </AppShellContentContainer>
+      </AppTopbarAdjusterWrapper>
+    </ProtectedRoute>
+  )
+}
+```
+
+Add the sidebar entry as a system node in `core/config/organization-model.ts`:
+
+`systems` is an id-keyed record, not an array, and `order` is required on every entry:
+
+<!-- doc-snippet:skip: illustrative excerpt, not a standalone compilable file -->
+
+```ts
+systems: {
+  mySystem: {
+    id: 'my-system',
+    order: 50,
+    label: 'My System',
+    lifecycle: 'active',
+    ui: { path: '/my-system', icon: 'star' }
+  }
+}
+```
+
+TanStack Router derives the path from the filename. Sidebar placement is authored in `navigation.sidebar`, not on the System entry — `enabled`, `path`, `icon`, and `uiPosition` survive as top-level compatibility fields but are not the authoring surface. Use `lifecycle` for enablement and `ui.path` for route matching.
+
 ## 2. Add an Access-Gated Page
 
 Wrap the route with `AccessGuard` and use the same system path as the org model node.
@@ -70,7 +71,7 @@ function MySystemRouteComponent() {
         <AppTopbarAdjusterWrapper>
           <AppShellContentContainer>
             <PageContainer>
-              <MySystemPage />
+              <MySystemPage />
             </PageContainer>
           </AppShellContentContainer>
         </AppTopbarAdjusterWrapper>
@@ -81,144 +82,175 @@ function MySystemRouteComponent() {
 ```
 
 Set `lifecycle` to an inactive state in the system node to hide or deny access by default. Use `AccessKeys.platformAdmin` with `AccessGuard` for platform-admin-only pages.
-
-## 3. Add a Nested Page
-
-Create a layout file for the section and child route files under the same directory.
-
-```tsx
-import { createFileRoute, Outlet } from '@tanstack/react-router'
-import { ProtectedRoute } from '@/features/auth'
-
-export const Route = createFileRoute('/reporting')({
-  component: ReportingLayoutComponent
-})
-
-function ReportingLayoutComponent() {
-  return (
-    <ProtectedRoute>
-      <Outlet />
-    </ProtectedRoute>
-  )
-}
-```
-
-Add dotted system nodes for the sidebar hierarchy:
-
-```ts
-{ id: 'reporting', label: 'Reporting', enabled: true, uiPosition: 'sidebar-primary' },
-{ id: 'reporting.overview', label: 'Overview', enabled: true, path: '/reporting/overview' },
-{ id: 'reporting.reports', label: 'Reports', enabled: true, path: '/reporting/reports' }
-```
-
-Containers omit `path`; leaves provide `path`.
-
-## 4. Add a System-Scoped Component
-
-Use `ui/src/features/<name>/` when logic is shared across routes or owns local state.
-
-```text
-ui/src/features/reporting/
-  components/
-    ReportingOverviewPage.tsx
-    ReportCard.tsx
-  hooks/
-    useReports.ts
-  utils/
-    formatReportDate.ts
-  types.ts
-```
-
-Use `@/*` imports for app-local cross-system imports and keep route layout concerns in route files.
-
-## 5. Change Theme Tokens
-
-Edit `ui/src/config/theme.ts`.
-
-```ts
-default: {
-  label: 'Default',
-  description: 'Project brand theme',
-  colors: ['#2563eb', '#080808', '#f2f2f5'],
-  dark: {
-    primary: '#2563eb',
-    primaryContrast: '#ffffff',
-    background: '#050507',
-    surface: '#0f0f14',
-    surfaceHover: '#1a1a22',
-    text: '#ffffff',
-    textDimmed: '#b0b0c0',
-    textSubtle: '#888898',
-    border: 'rgba(255, 255, 255, 0.07)'
-  }
-}
-```
-
-All tokens flow into CSS variables. Change `defaultPreset` to alter the initial preset for new users.
-
-## 6. Execute a Resource from a Surface
-
-Declare the resource descriptor in the Organization Model, then derive runtime metadata from that descriptor:
-
-```ts
-// core/config/organization-model.ts
-import { defineResources } from '@elevasis/core/organization-model'
-
-export const resourceDescriptors = defineResources({
-  writeNote: {
-    id: 'write-note',
-    kind: 'workflow',
-    systemPath: 'sys.sales',
-    ownerRoleId: 'role-sales-ops',
-    status: 'active',
-    codeRefs: [
-      {
-        path: 'operations/src/write-note/index.ts',
-        role: 'entrypoint',
-        symbol: 'writeNoteWorkflow'
-      }
-    ]
-  }
-})
-
-// operations/src/write-note/index.ts
-config: {
-  resource: resourceDescriptors.writeNote,
-  resourceId: resourceDescriptors.writeNote.id,
-  name: 'Write Note',
-  type: resourceDescriptors.writeNote.kind,
-  version: '1.0.0',
-  status: 'prod',
-  category: 'production'
-}
-```
-
-Render the deployed workflow with `RunResourceButton`:
-
-```tsx
-import { RunResourceButton } from '@elevasis/ui/components'
-import { writeNoteInputSchema } from '@core/types'
-
-export function DealPanel({ dealId }: { dealId: string }) {
-  return (
-    <RunResourceButton
-      resourceId="write-note"
-      resourceType="workflow"
-      label="Write Note"
-      getInput={() => ({
-        schema: writeNoteInputSchema,
-        defaults: { dealId }
-      })}
-    />
-  )
-}
-```
-
-`resourceDescriptors.writeNote.id` is the single authored ID. `RunResourceButton` still receives the deployed runtime ID. `codeRefs` point agents and operators at implementation files, while `links[].nodeId` binds the resource into the Organization Model graph. `category` drives operational filtering for production, diagnostic, internal, and testing resources.
-
-## Cross-References
-
-- `./feature-flags-and-gating.md` -- system and admin access model
-- `./feature-shell.mdx` -- provider and sidebar derivation
-- `./customization.md` -- system sidebar customization
-- `ui/src/config/README.md` -- theme, background, and loader config
+
+## 3. Add a Nested Page
+
+Create a layout file for the section and child route files under the same directory.
+
+```tsx
+import { createFileRoute, Outlet } from '@tanstack/react-router'
+import { ProtectedRoute } from '@/features/auth'
+
+export const Route = createFileRoute('/reporting')({
+  component: ReportingLayoutComponent
+})
+
+function ReportingLayoutComponent() {
+  return (
+    <ProtectedRoute>
+      <Outlet />
+    </ProtectedRoute>
+  )
+}
+```
+
+Add dotted system nodes for the sidebar hierarchy:
+
+Nest child Systems under the parent's own `systems` record rather than flattening dotted ids into one map:
+
+<!-- doc-snippet:skip: illustrative excerpt, not a standalone compilable file -->
+
+```ts
+systems: {
+  reporting: {
+    id: 'reporting',
+    order: 60,
+    label: 'Reporting',
+    lifecycle: 'active',
+    systems: {
+      overview: {
+        id: 'reporting.overview',
+        order: 10,
+        label: 'Overview',
+        lifecycle: 'active',
+        parentSystemId: 'reporting',
+        ui: { path: '/reporting/overview' }
+      },
+      reports: {
+        id: 'reporting.reports',
+        order: 20,
+        label: 'Reports',
+        lifecycle: 'active',
+        parentSystemId: 'reporting',
+        ui: { path: '/reporting/reports' }
+      }
+    }
+  }
+}
+```
+
+Containers omit `ui.path`; leaves provide it.
+
+## 4. Add a System-Scoped Component
+
+Use `ui/src/features/<name>/` when logic is shared across routes or owns local state.
+
+```text
+ui/src/features/reporting/
+  components/
+    ReportingOverviewPage.tsx
+    ReportCard.tsx
+  hooks/
+    useReports.ts
+  utils/
+    formatReportDate.ts
+  types.ts
+```
+
+Use `@/*` imports for app-local cross-system imports and keep route layout concerns in route files.
+
+## 5. Change Theme Tokens
+
+Edit `ui/src/config/theme.ts`.
+
+<!-- doc-snippet:skip: illustrative excerpt, not a standalone compilable file -->
+
+```ts
+default: {
+  label: 'Default',
+  description: 'Project brand theme',
+  colors: ['#2563eb', '#080808', '#f2f2f5'],
+  dark: {
+    primary: '#2563eb',
+    primaryContrast: '#ffffff',
+    background: '#050507',
+    surface: '#0f0f14',
+    surfaceHover: '#1a1a22',
+    text: '#ffffff',
+    textDimmed: '#b0b0c0',
+    textSubtle: '#888898',
+    border: 'rgba(255, 255, 255, 0.07)'
+  }
+}
+```
+
+All tokens flow into CSS variables. Change `defaultPreset` to alter the initial preset for new users.
+
+## 6. Execute a Resource from a Surface
+
+Declare the resource descriptor in the Organization Model, then derive runtime metadata from that descriptor:
+
+<!-- doc-snippet:skip: illustrative excerpt, not a standalone compilable file -->
+
+```ts
+// core/config/organization-model.ts
+import { defineResources } from '@elevasis/core/organization-model'
+
+export const resourceDescriptors = defineResources({
+  writeNote: {
+    id: 'write-note',
+    kind: 'workflow',
+    systemPath: 'sales',
+    ownerRoleId: 'role-sales-ops',
+    status: 'active',
+    codeRefs: [
+      {
+        path: 'operations/src/write-note/index.ts',
+        role: 'entrypoint',
+        symbol: 'writeNoteWorkflow'
+      }
+    ]
+  }
+})
+
+// operations/src/write-note/index.ts
+config: {
+  resource: resourceDescriptors.writeNote,
+  resourceId: resourceDescriptors.writeNote.id,
+  name: 'Write Note',
+  type: resourceDescriptors.writeNote.kind,
+  version: '1.0.0',
+  status: 'prod',
+  category: 'production'
+}
+```
+
+Render the deployed workflow with `RunResourceButton`:
+
+```tsx
+import { RunResourceButton } from '@elevasis/ui/components'
+import { writeNoteInputSchema } from '@core/types'
+
+export function DealPanel({ dealId }: { dealId: string }) {
+  return (
+    <RunResourceButton
+      resourceId="write-note"
+      resourceType="workflow"
+      label="Write Note"
+      getInput={() => ({
+        schema: writeNoteInputSchema,
+        defaults: { dealId }
+      })}
+    />
+  )
+}
+```
+
+`resourceDescriptors.writeNote.id` is the single authored ID. `RunResourceButton` still receives the deployed runtime ID. `codeRefs` on the OM `ResourceEntry` point agents and operators at implementation files. `config.resourceId` / `type` / `category` above are runtime deployment-registry fields, not part of the OM `ResourceEntry` schema -- `links[].nodeId` and `category` are runtime filter overlays for Command Center faceted filtering, not OM resource identity. The canonical OM attachment is `resource.systemPath`.
+
+## Cross-References
+
+- `./feature-flags-and-gating.md` -- system and admin access model
+- `./feature-shell.mdx` -- provider and sidebar derivation
+- `./customization.md` -- system sidebar customization
+- `ui/src/config/README.md` -- theme, background, and loader config

package/reference/sdk/cli-management.mdx

@@ -416,7 +416,22 @@ JWT-gated routes at the original unprefixed paths remain for the Command Center.
 
 Full CRUD management for client records. The `client:*` family covers create, read, update, and delete operations at `/api/external/clients`.
 
-For complete field definitions, filter options, and relationship semantics, see the [Clients feature documentation](/technical/features/operations/clients).
+**Field definitions** (`ClientProfileSchema` in `@elevasis/core/organization-model`):
+
+| Field          | Shape                                                                                          |
+| -------------- | ---------------------------------------------------------------------------------------------- |
+| `id`           | UUID                                                                                           |
+| `slug`         | stable model id                                                                                |
+| `name`         | display label                                                                                  |
+| `status`       | `active | onboarding | paused | completed | churned` (default `onboarding`)                |
+| `source`       | optional lowercase source key                                                                  |
+| `identity`     | `organizationName`, `shortName`, `clientBrief`, `geographicFocus[]`, `timeZone`                |
+| `branding`     | `voice`, `tagline`, `values[]`                                                                 |
+| `workspace`    | `kind` (`external-project | internal-project | none`), `owner`, `projectId`, `workspacePath` |
+| `links`        | `projectIds[]`, `primaryCompanyId`, `primaryContactId`, `sourceDealId`                         |
+| `prompts`      | `defaultContext`                                                                               |
+| `config`       | free-form JSON record                                                                          |
+| `customValues` | free-form JSON record                                                                          |
 
 **Quick reference:**
 
@@ -506,12 +521,12 @@ must be exposed as a separate explicit command.
 
 **`session:turn` flags:**
 
-| Flag                        | Description                                  |
-| --------------------------- | -------------------------------------------- |
-| `-i, --input <json>`      | Turn input as JSON                           |
-| `-f, --input-file <path>` | Read turn input from a JSON file             |
-| `--json`                    | Output as JSON                               |
-| `--api-url <url>`         | Override the API base URL                    |
+| Flag                        | Description                      |
+| --------------------------- | -------------------------------- |
+| `-i, --input <json>`      | Turn input as JSON               |
+| `-f, --input-file <path>` | Read turn input from a JSON file |
+| `--json`                    | Output as JSON                   |
+| `--api-url <url>`         | Override the API base URL        |
 
 **`session:messages` flags:**
 
@@ -547,7 +562,7 @@ must be exposed as a separate explicit command.
 
 ## elevasis-sdk queue:\*
 
-Manage HITL command queue tasks. See the [Command Queue CLI Guide](/technical/development/agent-driven-development/cli-operations) for the full command reference.
+Manage HITL command queue tasks.
 
 **Quick reference:**
 
@@ -583,13 +598,42 @@ elevasis-sdk queue:status --pretty
 | `--pretty`           | Human-readable output instead of raw JSON |
 | `--api-url <url>`  | Override the API base URL                 |
 
+**Shared flags (`queue:get`, `queue:expire`, `queue:status`):**
+
+| Flag                | Description                               |
+| ------------------- | ----------------------------------------- |
+| `--pretty`          | Human-readable output instead of raw JSON |
+| `--api-url <url>` | Override the API base URL                 |
+
 **Auth:** Calls `/api/external/command-queue/*` with API-key auth.
 
 ---
 
 ## elevasis-sdk schedule:\*
 
-Manage recurring, relative, and absolute task schedules. See the [Schedule CLI Guide](/technical/development/agent-driven-development/cli-operations) for the full command reference including schedule config JSON shapes.
+Manage recurring, relative, and absolute task schedules. `schedule:create` and `schedule:update --schedule-config` accept raw JSON; the CLI does not parse natural-language or shorthand cron flags.
+
+**`--schedule-config` JSON shapes:**
+
+```json
+// recurring, fixed interval
+{ "type": "recurring", "interval": "weekly", "time": "09:00", "timezone": "America/Los_Angeles", "payload": {} }
+```
+
+```json
+// recurring, cron expression
+{ "type": "recurring", "cron": "0 9 * * 1", "timezone": "America/Los_Angeles", "payload": {} }
+```
+
+```json
+// relative to an anchor time
+{ "type": "relative", "anchorAt": "2026-06-01T00:00:00Z", "payload": {} }
+```
+
+```json
+// absolute, one or more fixed run times
+{ "type": "absolute", "items": [{ "runAt": "2026-06-01T09:00:00Z", "payload": {}, "label": "Launch" }] }
+```
 
 **Quick reference:**
 
@@ -623,9 +667,13 @@ At least one field must be provided. `--description` and `--clear-description` a
 
 ## elevasis-sdk om:\*
 
-Knowledge map inspection. The `om:*` (Organization Model) commands expose knowledge graph traversal via the CLI.
+Knowledge map inspection. The `om:*` (Organization Model) commands expose knowledge graph traversal via the CLI. `om:*` and `knowledge:*` are aliases of the same subcommands.
+
+**Path axes for `knowledge:ls` / `om:ls`:** `/by-system/<id>`, `/by-ontology/<ontologyId>`, `/by-kind/<kind>`, `/by-owner/<ownerId>`, `/by-domain/<domain>` (enumerate all items in a domain: `clients`, `roles`, `policies`, `customers`, `offerings`, `goals`), `/by-item/<domain>/<itemId>` (single domain-item profile), `/graph/<nodeId>/governs`, `/graph/<nodeId>/governed-by`, `/<nodeId>` (single node), `/all-systems`, `/all-resources`, `/all-roles`.
 
-For the full command reference, flag details, and graph architecture, see the [knowledge:\* CLI documentation](/technical/features/knowledge/cli-and-skill).
+- `knowledge:ls <path>` -- list nodes/edges for the mount; default output is an id + summary table, `--json` returns `{ path, mount, args, results }`.
+- `knowledge:cat <id>` -- render a node's `body` MDX to stdout; `--json` returns the full node object (body, links, owners, timestamps).
+- `knowledge:graph <id>` -- show outgoing + incoming edges grouped by edge kind.
 
 In tenant projects, SDK read commands load `core/config/organization-model.ts` through the SDK's layout-aware TypeScript loader. The temporary bundle and dependency resolution are anchored at the package root that owns SDK dependencies, so hoisted pnpm workspaces resolve `esbuild` and `@elevasis/core` correctly. Missing org-model files still return the default model; malformed files or files with no usable export emit diagnostics. `knowledge:generate` / `om:generate` is the exception because it reads MDX and codegen inputs directly.
 
@@ -761,25 +809,25 @@ The same coverage gate runs inside `elevasis-sdk check` when the coverage regist
 
 Current status of all SDK CLI domains. Domains marked `deferred` have no CLI commands yet.
 
-| Domain      | CLI surface                                                               | API surface                                                    | Status                        |
-| ----------- | ------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------------------------- |
-| platform    | top-level SDK commands                                                    | mixed platform APIs                                            | implemented                   |
-| project     | `project:*`                                                               | `apps/api/src/projects/`                                       | implemented                   |
-| knowledge   | `knowledge:*`                                                             | file/generated knowledge data                                  | implemented                   |
-| creds       | `creds *` nested Commander group                                          | credentials API                                                | implemented                   |
-| ui          | `ui:*`                                                                    | local project file edits                                       | implemented                   |
-| request     | `request:submit`, `request:list`, `request:get`                           | requests API                                                   | implemented read/write scope  |
-| error       | `error resolve`, `error resolve-execution`                                | execution error APIs                                           | partial                       |
-| acquisition | `acquisition:list:*`, `acquisition:deal:*`                                | `/api/external/acquisition/lists*`, `/api/external/deals*`     | implemented read-only scope   |
-| client      | `client:*`                                                                | `/api/external/clients`                                        | implemented read/write scope  |
-| agent       | `agent:list`, `agent:get`                                                 | `/api/external/agents*`                                        | implemented read-only scope   |
+| Domain      | CLI surface                                                                                        | API surface                                                    | Status                        |
+| ----------- | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ----------------------------- |
+| platform    | top-level SDK commands                                                                             | mixed platform APIs                                            | implemented                   |
+| project     | `project:*`                                                                                        | `apps/api/src/projects/`                                       | implemented                   |
+| knowledge   | `knowledge:*`                                                                                      | file/generated knowledge data                                  | implemented                   |
+| creds       | `creds *` nested Commander group                                                                   | credentials API                                                | implemented                   |
+| ui          | `ui:*`                                                                                             | local project file edits                                       | implemented                   |
+| request     | `request:submit`, `request:list`, `request:get`                                                    | requests API                                                   | implemented read/write scope  |
+| error       | `error resolve`, `error resolve-execution`                                                         | execution error APIs                                           | partial                       |
+| acquisition | `acquisition:list:*`, `acquisition:deal:*`                                                         | `/api/external/acquisition/lists*`, `/api/external/deals*`     | implemented read-only scope   |
+| client      | `client:*`                                                                                         | `/api/external/clients`                                        | implemented read/write scope  |
+| agent       | `agent:list`, `agent:get`                                                                          | `/api/external/agents*`                                        | implemented read-only scope   |
 | session     | `session:create`, `session:turn`, `session:messages`, `session:list`, `session:get`, `session:end` | `/api/external/sessions*`                                      | implemented multi-turn scope  |
-| queue       | `queue:list`, `queue:get`, `queue:select`, `queue:expire`, `queue:status` | `/api/external/command-queue*`                                 | implemented                   |
-| schedule    | `schedule:list`, `schedule:get`, `schedule:create`, `schedule:update`     | `/api/external/task-scheduler/schedules*`                      | implemented                   |
-| skill       | `skill:scaffold`, `skill:check-coverage`                                  | local CLI catalog and `.claude/registries/skill-coverage.json` | implemented developer tooling |
-| content     | none                                                                      | not scoped here                                                | deferred                      |
-| seo         | none                                                                      | not scoped here                                                | deferred                      |
-| monitoring  | none                                                                      | not scoped here                                                | deferred                      |
+| queue       | `queue:list`, `queue:get`, `queue:select`, `queue:expire`, `queue:status`                          | `/api/external/command-queue*`                                 | implemented                   |
+| schedule    | `schedule:list`, `schedule:get`, `schedule:create`, `schedule:update`                              | `/api/external/task-scheduler/schedules*`                      | implemented                   |
+| skill       | `skill:scaffold`, `skill:check-coverage`                                                           | local CLI catalog and `.claude/registries/skill-coverage.json` | implemented developer tooling |
+| content     | none                                                                                               | not scoped here                                                | deferred                      |
+| seo         | none                                                                                               | not scoped here                                                | deferred                      |
+| monitoring  | none                                                                                               | not scoped here                                                | deferred                      |
 
 ### Promotion Criteria
 

package/reference/sdk/concepts.mdx

@@ -75,6 +75,8 @@ The Elevasis SDK uses [Zod](https://zod.dev) for schema definition. Zod is a Typ
 
 `z.infer` creates a TypeScript type from a schema so the type system can check your code. You define the schema once and get both runtime validation and compile-time checking. Without it, you would have to define the same shape twice -- once as a Zod schema and once as a TypeScript type.
 
+{/* doc-snippet:skip: illustrative excerpt -- omits `import { z } from 'zod'` since the point is z.infer's behavior, not a runnable module */}
+
 ```ts
 const myInput = z.object({ name: z.string(), age: z.number() });
 type MyInput = z.infer<typeof myInput>;