gen

type AiConfigOwnerType string

type AppType string

type AppsAppsApp struct {
	Id          string  `json:"id"`
	Urn         string  `json:"urn"`
	Name        string  `json:"name"`
	AppType     AppType `json:"appType"`
	AgentId     *string `json:"agentId"`
	MemberCount int     `json:"memberCount"`
	CreatedAt   string  `json:"createdAt"`
}

type AppsResponse struct {
	// Apps in an organization (org ADMIN).
	//
	// Accepts the entity's ID or URN.
	Apps []*AppsAppsApp `json:"apps"`
}

type CloneMemoryCloneMemory struct {
	Id               string            `json:"id"`
	Urn              string            `json:"urn"`
	Name             string            `json:"name"`
	ShortDescription *string           `json:"shortDescription"`
	Class            MemoryClass       `json:"class"`
	Visibility       *MemoryVisibility `json:"visibility"`
	OrganizationId   string            `json:"organizationId"`
	IsEncrypted      bool              `json:"isEncrypted"`
	UpdatedAt        string            `json:"updatedAt"`
}

type CloneMemoryResponse struct {
	// Clone a Memory into a new Memory (same org) named `name`.
	//
	// Accepts the source's ID or URN. Copies the Memory row plus all live
	// Nodes, Edges, and PendingEdges; references to the source memory's URN
	// inside node content/abstract (canonical and legacy spellings) are
	// rewritten to the clone's URN. Vector-index config carries over and the
	// clone's nodes are stamped for re-embedding.
	//
	// NOT copied: version history, subscriptions, shares, group members
	// (the caller is bootstrapped as a group clone's first owner), sessions,
	// licenses, log entries, assets, and git-sync config (the clone starts
	// DB-only).
	//
	// Authorization mirrors deleteMemory: personal/private → owner only;
	// knowledge/group → org ADMIN. system/app-class sources and encrypted
	// memories are rejected.
	CloneMemory *CloneMemoryCloneMemory `json:"cloneMemory"`
}

type CreateAppCreateApp struct {
	Id          string  `json:"id"`
	Urn         string  `json:"urn"`
	Name        string  `json:"name"`
	AppType     AppType `json:"appType"`
	AgentId     *string `json:"agentId"`
	MemberCount int     `json:"memberCount"`
	CreatedAt   string  `json:"createdAt"`
}

type CreateAppResponse struct {
	// Install an Agent into an organization, creating an App that deploys it.
	//
	// Auto-provisions an AgentOrgGrant for (orgId, agentId) on first install,
	// and adds the caller as an AppMember with role 'owner'. Required
	// AgentImports cascade automatically; optional imports cascade only when
	// their id appears in installOptional.
	//
	// 009-install-agent-flow: the cross-org install restriction (FR-009) is
	// enforced at the portal — the Install affordance is hidden for Agents
	// not owned by the calling org. The server still auto-provisions grants
	// on first install (preserved from 008); a hard server-side cross-org
	// gate is reserved for the marketplace spec.
	//
	// Accepts the entity's ID or URN.
	CreateApp *CreateAppCreateApp `json:"createApp"`
}

type CreateEdgeCreateEdge struct {
	Id       string                          `json:"id"`
	Label    string                          `json:"label"`
	Priority int                             `json:"priority"`
	Source   *CreateEdgeCreateEdgeSourceNode `json:"source"`
	Target   *CreateEdgeCreateEdgeTargetNode `json:"target"`
}

type CreateEdgeCreateEdgeSourceNode struct {
	Id  string `json:"id"`
	Loc string `json:"loc"`
}

type CreateEdgeCreateEdgeTargetNode struct {
	Id  string `json:"id"`
	Loc string `json:"loc"`
}

type CreateEdgeResponse struct {
	CreateEdge *CreateEdgeCreateEdge `json:"createEdge"`
}

type CreateMemoryCreateMemory struct {
	Id               string            `json:"id"`
	Urn              string            `json:"urn"`
	Name             string            `json:"name"`
	ShortDescription *string           `json:"shortDescription"`
	Class            MemoryClass       `json:"class"`
	Visibility       *MemoryVisibility `json:"visibility"`
	OrganizationId   string            `json:"organizationId"`
	IsEncrypted      bool              `json:"isEncrypted"`
	UpdatedAt        string            `json:"updatedAt"`
}

type CreateMemoryResponse struct {
	// Create a memory in an organization. Accepts the entity's ID or URN
	// for orgId.
	//
	// Defaults to knowledge-class with ORGANIZATION visibility. Pass
	// memoryClass: group + visibility: GROUP for a group-class memory
	// (023-app-shape US4; the caller is auto-added as the first owner),
	// or memoryClass: personal | private for an owner-only memory the
	// caller owns (spec 034 — free-standing, no app/agent; the caller
	// must be a member of the org container). system- and app-class
	// memories are NOT created here — they auto-provision via
	// Agent.systemMemoryId / the App install path.
	CreateMemory *CreateMemoryCreateMemory `json:"createMemory"`
}

type DeleteAppResponse struct {
	// Soft-delete an App.
	//
	// Accepts the entity's ID or URN.
	DeleteApp bool `json:"deleteApp"`
}

type DeleteEdgeResponse struct {
	DeleteEdge bool `json:"deleteEdge"`
}

type DeleteMemoryResponse struct {
	// Soft-delete a Memory.
	//
	// Accepts the entity's ID or URN.
	DeleteMemory bool `json:"deleteMemory"`
}

type DeleteNodeResponse struct {
	DeleteNode bool `json:"deleteNode"`
}

type GetMemoryMemory struct {
	Id                 string            `json:"id"`
	Urn                string            `json:"urn"`
	Name               string            `json:"name"`
	ShortDescription   *string           `json:"shortDescription"`
	Description        *string           `json:"description"`
	Class              MemoryClass       `json:"class"`
	Visibility         *MemoryVisibility `json:"visibility"`
	OrganizationId     string            `json:"organizationId"`
	IsEncrypted        bool              `json:"isEncrypted"`
	Tags               []string          `json:"tags"`
	Source             *string           `json:"source"`
	SyncStatus         SyncStatus        `json:"syncStatus"`
	VectorIndexEnabled bool              `json:"vectorIndexEnabled"`
	// Free-form structured metadata bag (client-defined JSON, no server-side
	// semantics). Null when unset. Settable via createMemory / updateMemory.
	Data      *json.RawMessage `json:"data"`
	CreatedAt string           `json:"createdAt"`
	UpdatedAt string           `json:"updatedAt"`
}

type GetMemoryResponse struct {
	// Fetch a single Memory (org member or platform ADMIN).
	//
	// Accepts the entity's ID or URN.
	Memory *GetMemoryMemory `json:"memory"`
}

type GetNodeByIdNodeByIdNode struct {
	Id          string  `json:"id"`
	MemoryId    string  `json:"memoryId"`
	Loc         string  `json:"loc"`
	Name        string  `json:"name"`
	Description *string `json:"description"`
	// Paragraph-length summary of this node. Opt-in on h-read-node via the contentScope parameter. h-find-nodes preview surfacing ships in spec 031 US2 — not yet live. Never surfaced in h-list-nodes. Cap is 2000 characters; longer values are rejected with NodeAbstractTooLongError. Empty + whitespace-only values normalize to null. Spec 031.
	Abstract *string `json:"abstract"`
	// Spec 032 — fingerprint of the content value at the time abstract was authored. SHA-256 of plaintext content, truncated to 8 hex chars. Compared at read time against computeContentHash(node.content) to detect staleness; when the two values differ AND abstractOriginHash is non-null, the abstract may not reflect current content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string                                     `json:"abstractOriginHash"`
	NodeType           string                                      `json:"nodeType"`
	Tags               []string                                    `json:"tags"`
	Content            *string                                     `json:"content"`
	Data               *json.RawMessage                            `json:"data"`
	Seq                *int                                        `json:"seq"`
	CreatedAt          string                                      `json:"createdAt"`
	UpdatedAt          string                                      `json:"updatedAt"`
	OutgoingEdges      []*GetNodeByIdNodeByIdNodeOutgoingEdgesEdge `json:"outgoingEdges"`
	IncomingEdges      []*GetNodeByIdNodeByIdNodeIncomingEdgesEdge `json:"incomingEdges"`
}

type GetNodeByIdNodeByIdNodeIncomingEdgesEdge struct {
	Id       string                                              `json:"id"`
	Label    string                                              `json:"label"`
	Priority int                                                 `json:"priority"`
	Source   *GetNodeByIdNodeByIdNodeIncomingEdgesEdgeSourceNode `json:"source"`
}

type GetNodeByIdNodeByIdNodeIncomingEdgesEdgeSourceNode struct {
	Id       string `json:"id"`
	Loc      string `json:"loc"`
	MemoryId string `json:"memoryId"`
}

type GetNodeByIdNodeByIdNodeOutgoingEdgesEdge struct {
	Id       string                                              `json:"id"`
	Label    string                                              `json:"label"`
	Priority int                                                 `json:"priority"`
	Target   *GetNodeByIdNodeByIdNodeOutgoingEdgesEdgeTargetNode `json:"target"`
}

type GetNodeByIdNodeByIdNodeOutgoingEdgesEdgeTargetNode struct {
	Id       string `json:"id"`
	Loc      string `json:"loc"`
	MemoryId string `json:"memoryId"`
}

type GetNodeByIdResponse struct {
	NodeById *GetNodeByIdNodeByIdNode `json:"nodeById"`
}

type MeMeUser struct {
	Id             string  `json:"id"`
	Name           *string `json:"name"`
	Email          *string `json:"email"`
	Handle         *string `json:"handle"`
	GithubUsername *string `json:"githubUsername"`
	Roles          []Role  `json:"roles"`
}

type MeResponse struct {
	Me *MeMeUser `json:"me"`
}

type MemoryClass string

type MemoryVisibility string

type MyMemoriesMyMemoriesMemory struct {
	Id               string            `json:"id"`
	Urn              string            `json:"urn"`
	Name             string            `json:"name"`
	ShortDescription *string           `json:"shortDescription"`
	Class            MemoryClass       `json:"class"`
	Visibility       *MemoryVisibility `json:"visibility"`
	OrganizationId   string            `json:"organizationId"`
	IsEncrypted      bool              `json:"isEncrypted"`
	UpdatedAt        string            `json:"updatedAt"`
}

type MyMemoriesResponse struct {
	MyMemories []*MyMemoriesMyMemoriesMemory `json:"myMemories"`
}

type NodeBatchNodeBatchNodeBatchResult struct {
	Truncated   bool                                          `json:"truncated"`
	Omitted     []string                                      `json:"omitted"`
	Unavailable []string                                      `json:"unavailable"`
	Nodes       []*NodeBatchNodeBatchNodeBatchResultNodesNode `json:"nodes"`
}

type NodeBatchNodeBatchNodeBatchResultNodesNode struct {
	Id          string  `json:"id"`
	MemoryId    string  `json:"memoryId"`
	Loc         string  `json:"loc"`
	Name        string  `json:"name"`
	Alias       *string `json:"alias"`
	NodeType    string  `json:"nodeType"`
	Description *string `json:"description"`
	// Paragraph-length summary of this node. Opt-in on h-read-node via the contentScope parameter. h-find-nodes preview surfacing ships in spec 031 US2 — not yet live. Never surfaced in h-list-nodes. Cap is 2000 characters; longer values are rejected with NodeAbstractTooLongError. Empty + whitespace-only values normalize to null. Spec 031.
	Abstract *string `json:"abstract"`
	// Spec 032 — fingerprint of the content value at the time abstract was authored. SHA-256 of plaintext content, truncated to 8 hex chars. Compared at read time against computeContentHash(node.content) to detect staleness; when the two values differ AND abstractOriginHash is non-null, the abstract may not reflect current content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string                                                        `json:"abstractOriginHash"`
	Tags               []string                                                       `json:"tags"`
	Seq                *int                                                           `json:"seq"`
	Data               *json.RawMessage                                               `json:"data"`
	Properties         *json.RawMessage                                               `json:"properties"`
	Content            *string                                                        `json:"content"`
	UpdatedAt          string                                                         `json:"updatedAt"`
	OutgoingEdges      []*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge `json:"outgoingEdges"`
	IncomingEdges      []*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge `json:"incomingEdges"`
}

type NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge struct {
	Label  string                                                                 `json:"label"`
	Source *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode `json:"source"`
}

type NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode struct {
	Id       string `json:"id"`
	Loc      string `json:"loc"`
	MemoryId string `json:"memoryId"`
}

type NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge struct {
	Label     string                                                                 `json:"label"`
	Priority  int                                                                    `json:"priority"`
	Condition *json.RawMessage                                                       `json:"condition"`
	Target    *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode `json:"target"`
}

type NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode struct {
	Id       string `json:"id"`
	Loc      string `json:"loc"`
	MemoryId string `json:"memoryId"`
}

type NodeBatchResponse struct {
	// Batch read (spec cor:api:040) — the full node projection (select any Node
	// fields, including content + edges) for MANY nodes in one call, eliminating
	// the N+1 of one nodeById per node (e.g. 'spec lint --all'). Provide EITHER
	// 'ids' (explicit set, returned in input order) OR 'memory' + 'locPrefix'
	// (subtree, loc order) — not both. Per-node access is applied independently:
	// denied or missing ids come back in 'unavailable' and never fail the call.
	// Bounded by hard caps — over the node-count cap throws BAD_USER_INPUT; over
	// the response-size cap returns a partial result with 'truncated: true' and
	// the dropped ids in 'omitted' (never a silent short read). Node content is
	// returned raw — Mustache templates are NOT compiled (unlike single-node
	// 'node'/'nodeById'), since this is a bulk source read for lint / audit /
	// migration and compiling per node would re-introduce the N+1 it eliminates.
	NodeBatch *NodeBatchNodeBatchNodeBatchResult `json:"nodeBatch"`
}

type NodeEdgeInput struct {
	Label *string `json:"label"`
	// Reference to the target node. Accepts a node ID, a full URN
	// (hrn:node:<memory-urn>::<loc>), a memory-prefixed loc
	// (<memory-urn>:<loc>), or a short loc resolved within the source
	// node's memory.
	TargetId string `json:"targetId"`
}

type NodeInput struct {
	// Paragraph-length summary of this node — see Node.abstract for the surfacing contract (h-read-node opt-in via contentScope; h-find-nodes preview ships in US2). Optional. Omit to preserve; null to clear; string to replace. Empty + whitespace-only normalize to null. Cap is 2000 characters.
	Abstract    *string          `json:"abstract,omitempty"`
	AiAgent     *string          `json:"aiAgent,omitempty"`
	Alias       *string          `json:"alias,omitempty"`
	Content     *string          `json:"content,omitempty"`
	CreateOnly  *bool            `json:"createOnly,omitempty"`
	Data        *json.RawMessage `json:"data,omitempty"`
	Description *string          `json:"description,omitempty"`
	Edges       []*NodeEdgeInput `json:"edges,omitempty"`
	Id          *string          `json:"id,omitempty"`
	LlmModel    *string          `json:"llmModel,omitempty"`
	Loc         string           `json:"loc"`
	// Memory reference. Accepts the entity's ID (CUID / 32-char hex) or its
	// URN (per spec 007 ID-or-URN dispatch). URN inputs MUST be fully
	// qualified (org:memory) per spec 022 — relative-form URNs are
	// rejected as GraphQL errors with extensions.code "URN_NOT_QUALIFIED".
	MemoryId   string           `json:"memoryId"`
	Name       string           `json:"name"`
	NodeType   *string          `json:"nodeType,omitempty"`
	OwnerRepo  *string          `json:"ownerRepo,omitempty"`
	Properties *json.RawMessage `json:"properties,omitempty"`
	Seq        *int             `json:"seq,omitempty"`
	Tags       []string         `json:"tags,omitempty"`
}

type NodeSearchNodeSearchNodeSearchResult struct {
	Degraded *string                                          `json:"degraded"`
	Reason   *string                                          `json:"reason"`
	Nodes    []*NodeSearchNodeSearchNodeSearchResultNodesNode `json:"nodes"`
}

type NodeSearchNodeSearchNodeSearchResultNodesNode struct {
	Id        string   `json:"id"`
	MemoryId  string   `json:"memoryId"`
	Loc       string   `json:"loc"`
	Name      string   `json:"name"`
	NodeType  string   `json:"nodeType"`
	Tags      []string `json:"tags"`
	UpdatedAt string   `json:"updatedAt"`
}

type NodeSearchResponse struct {
	// Vector/hybrid-aware search over a memory. Keyword-only callers should
	// keep using the legacy 'nodes' query — nodeSearch is the
	// vector-aware entrypoint per spec 033 contract.
	//
	// mode defaults to vector (the vector-aware entrypoint design — the
	// MCP h-find-nodes tool defaults to keyword for backward-compat,
	// a deliberate divergence between the two surfaces). expand (graph
	// neighbor depth 0..3, default 0) and granularity:chunk (passage
	// retrieval, vector-mode only) are both fully live.
	//
	// Access control: same memory-read gate as the keyword nodes query —
	// the raw-SQL similarity query is scoped to memories the caller can
	// read, never cross-memory.
	NodeSearch *NodeSearchNodeSearchNodeSearchResult `json:"nodeSearch"`
}

type NodesNodesNode struct {
	Id        string   `json:"id"`
	MemoryId  string   `json:"memoryId"`
	Loc       string   `json:"loc"`
	Name      string   `json:"name"`
	NodeType  string   `json:"nodeType"`
	Tags      []string `json:"tags"`
	UpdatedAt string   `json:"updatedAt"`
}

type NodesResponse struct {
	Nodes []*NodesNodesNode `json:"nodes"`
}

type ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig struct {
	Id        string            `json:"id"`
	Name      string            `json:"name"`
	OwnerType AiConfigOwnerType `json:"ownerType"`
	// ID of the owning HadronServer / Organization / App / Agent.
	OwnerId string `json:"ownerId"`
	// Provider identifier; v1 known: 'anthropic' | 'openai' | 'glm' | 'bedrock'.
	Provider string `json:"provider"`
	// Model identifier, passed verbatim to the provider.
	Model     string `json:"model"`
	HasApiKey bool   `json:"hasApiKey"`
	// Ellipsis + last 4 characters of the stored key; null when no key.
	ApiKeyPreview *string `json:"apiKeyPreview"`
	// Provider-specific knobs (maxTokens, thinking, effort, baseUrl, ...).
	Params *json.RawMessage `json:"params"`
	// Disabled configs are skipped by resolution (the walk continues outward).
	Enabled   bool    `json:"enabled"`
	CreatedAt string  `json:"createdAt"`
	UpdatedAt *string `json:"updatedAt"`
}

type ResolveAiServiceConfigsResponse struct {
	// 036-ai-service-config: the MASKED set of configs RESOLVABLE in an
	// execution context — every distinct config name a chat in this context
	// could select. Populates a config picker in the chatbot UI.
	//
	// Same walk as resolveAIConfig (App -> Agent -> Org (of the App, else of
	// the Agent) -> HadronServer), but returns ALL names instead of resolving
	// one: configs are deduped by name with the innermost owner winning, so
	// each entry is the row resolveAIConfig would return for that name. Only
	// the Agent named here contributes — sibling Agents installed in the same
	// App are not consulted. Disabled configs are skipped. Never returns key
	// material (hasApiKey + apiKeyPreview only).
	//
	// Auth: scoped to one App's chat context. A non-admin caller MUST pass an
	// appId, be a member of that App, and (when an agentId is given) the Agent
	// must be installed in that App. Because the result is masked (no key
	// material), App membership — not org admin — is the bar, unlike
	// resolveAIConfig and the aiServiceConfigs management list. Platform
	// ADMIN/OWNER are always allowed and may omit appId.
	//
	// appId/agentId accept the entity's ID or URN.
	ResolveAiServiceConfigs []*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig `json:"resolveAiServiceConfigs"`
}

type ResolveUrnResolveUrnUrnResolution struct {
	Id       string  `json:"id"`
	Kind     string  `json:"kind"`
	MemoryId *string `json:"memoryId"`
}

type ResolveUrnResponse struct {
	// Resolve a fully-qualified, `hrn:<type>:`-prefixed Hadron URN (legacy `urn:` scheme also accepted) to the ids
	// needed to reach its canonical page. Returns null when the URN is
	// unresolvable (not found) OR the caller lacks access. Unlike the dedicated
	// per-kind queries — which throw `Forbidden` on no-access — this query
	// deliberately collapses both not-found and no-access to null, so a
	// redirect resolver can 404 uniformly without disclosing which case it was.
	//
	// Per-kind access uses the SAME authorization rules as the dedicated
	// queries (memory/org/agent: org membership; app: org ADMIN; node:
	// memoryAccessFilter), only with the throw replaced by a null return.
	//
	// The `hrn:<type>:` prefix (legacy `urn:<type>:` also accepted) is the
	// dispatch key — bare URNs without a type prefix are ambiguous across kinds
	// (`org::slug` could be a memory or an agent) and resolve to null.
	ResolveUrn *ResolveUrnResolveUrnUrnResolution `json:"resolveUrn"`
}

type Role string

type SearchMode string

type SyncStatus string

type UpdateEdgeResponse struct {
	UpdateEdge *UpdateEdgeUpdateEdge `json:"updateEdge"`
}

type UpdateEdgeUpdateEdge struct {
	Id       string                          `json:"id"`
	Label    string                          `json:"label"`
	Priority int                             `json:"priority"`
	Source   *UpdateEdgeUpdateEdgeSourceNode `json:"source"`
	Target   *UpdateEdgeUpdateEdgeTargetNode `json:"target"`
}

type UpdateEdgeUpdateEdgeSourceNode struct {
	Id  string `json:"id"`
	Loc string `json:"loc"`
}

type UpdateEdgeUpdateEdgeTargetNode struct {
	Id  string `json:"id"`
	Loc string `json:"loc"`
}

type UpdateMemoryResponse struct {
	// Update a Memory.
	//
	// Accepts the entity's ID or URN.
	//
	// Spec 033 FR-026: enabling `vectorIndexEnabled` on an `isEncrypted` memory
	// requires `acknowledgeVectorInversionRisk: true` in the same call. Without
	// the flag, an `EncryptedVectorIndexNotAcknowledgedError` is thrown carrying
	// the full four-point disclosure on `error.disclosure` (single source of
	// truth in `FR_026_DISCLOSURE` — see `src/lib/entityRef/errors.ts`). On a
	// non-encrypted memory the flag is a no-op.
	UpdateMemory *UpdateMemoryUpdateMemory `json:"updateMemory"`
}

type UpdateMemoryUpdateMemory struct {
	Id               string            `json:"id"`
	Urn              string            `json:"urn"`
	Name             string            `json:"name"`
	ShortDescription *string           `json:"shortDescription"`
	Class            MemoryClass       `json:"class"`
	Visibility       *MemoryVisibility `json:"visibility"`
	OrganizationId   string            `json:"organizationId"`
	IsEncrypted      bool              `json:"isEncrypted"`
	// Free-form structured metadata bag (client-defined JSON, no server-side
	// semantics). Null when unset. Settable via createMemory / updateMemory.
	Data      *json.RawMessage `json:"data"`
	UpdatedAt string           `json:"updatedAt"`
}

type UpsertNodeResponse struct {
	UpsertNode *UpsertNodeUpsertNode `json:"upsertNode"`
}

type UpsertNodeUpsertNode struct {
	Id        string   `json:"id"`
	MemoryId  string   `json:"memoryId"`
	Loc       string   `json:"loc"`
	Name      string   `json:"name"`
	NodeType  string   `json:"nodeType"`
	Tags      []string `json:"tags"`
	UpdatedAt string   `json:"updatedAt"`
}