gen

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 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"`
	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"`
	NodeType      string                                      `json:"nodeType"`
	Tags          []string                                    `json:"tags"`
	Content       *string                                     `json:"content"`
	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 NodeEdgeInput struct {
	Label *string `json:"label"`
	// Reference to the target node. Accepts a node ID, a full URN
	// (urn: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 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 ResolveUrnResolveUrnUrnResolution struct {
	Id       string  `json:"id"`
	Kind     string  `json:"kind"`
	MemoryId *string `json:"memoryId"`
}

type ResolveUrnResponse struct {
	// Resolve a fully-qualified, `urn:<type>:`-prefixed Hadron URN 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 `urn:<type>:` prefix 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 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"`
	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"`
}