Help us shape the future of Go! Take the 2026 Go Developer Survey

gen

package
v0.19.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 2, 2026 License: MIT Imports: 4 Imported by: 0

Documentation

Index

Constants

View Source 
const AcceptInvitation_Operation = `
mutation AcceptInvitation ($slug: String!) {
	acceptInvitation(slug: $slug)
}
`

The mutation executed by AcceptInvitation.

View Source 
const ActionTickets_Operation = `` /* 338-byte string literal not displayed */

The query executed by ActionTickets.

View Source 
const AddMemoryMember_Operation = `` /* 300-byte string literal not displayed */

The mutation executed by AddMemoryMember.

View Source 
const AddOrgMember_Operation = `` /* 326-byte string literal not displayed */

The mutation executed by AddOrgMember.

View Source 
const AdvanceChannelReadState_Operation = `` /* 263-byte string literal not displayed */

The mutation executed by AdvanceChannelReadState.

View Source 
const AgentSchedules_Operation = `` /* 407-byte string literal not displayed */

The query executed by AgentSchedules.

View Source 
const AgentWebhooks_Operation = `` /* 390-byte string literal not displayed */

The query executed by AgentWebhooks.

View Source 
const Agents_Operation = `` /* 392-byte string literal not displayed */

The query executed by Agents.

View Source 
const AiProviderEndpoints_Operation = `` /* 132-byte string literal not displayed */

The query executed by AiProviderEndpoints.

View Source 
const AiServiceConfigWithEndpoint_Operation = `` /* 323-byte string literal not displayed */

The query executed by AiServiceConfigWithEndpoint.

View Source 
const AppAgentRoster_Operation = `` /* 194-byte string literal not displayed */

The query executed by AppAgentRoster.

View Source 
const AppRun_Operation = `` /* 353-byte string literal not displayed */

The query executed by AppRun.

View Source 
const AppRuns_Operation = `` /* 523-byte string literal not displayed */

The query executed by AppRuns.

View Source 
const ApplyMemoryConfigTemplate_Operation = `` /* 983-byte string literal not displayed */

The mutation executed by ApplyMemoryConfigTemplate.

View Source 
const ApproveMemoryNodes_Operation = `` /* 375-byte string literal not displayed */

The mutation executed by ApproveMemoryNodes.

View Source 
const ApproveNode_Operation = `` /* 304-byte string literal not displayed */

The mutation executed by ApproveNode.

View Source 
const Apps_Operation = `` /* 244-byte string literal not displayed */

The query executed by Apps.

View Source 
const AssetDownloadUrl_Operation = `` /* 181-byte string literal not displayed */

The query executed by AssetDownloadUrl.

View Source 
const AttachMemoryToApp_Operation = `` /* 280-byte string literal not displayed */

The mutation executed by AttachMemoryToApp.

View Source 
const AuthContext_Operation = `` /* 424-byte string literal not displayed */

The query executed by AuthContext.

View Source 
const BeginAssetUpload_Operation = `` /* 425-byte string literal not displayed */

The mutation executed by BeginAssetUpload.

View Source 
const CancelAppRun_Operation = `` /* 365-byte string literal not displayed */

The mutation executed by CancelAppRun.

View Source 
const CastWorkerPreview_Operation = `` /* 301-byte string literal not displayed */

The query executed by CastWorkerPreview.

View Source 
const CastWorker_Operation = `` /* 470-byte string literal not displayed */

The mutation executed by CastWorker.

View Source 
const ChannelMessages_Operation = `` /* 488-byte string literal not displayed */

The query executed by ChannelMessages.

View Source 
const ChannelReadState_Operation = `` /* 223-byte string literal not displayed */

The query executed by ChannelReadState.

View Source 
const Channels_Operation = `` /* 453-byte string literal not displayed */

The query executed by Channels.

View Source 
const ChatMessages_Operation = `` /* 214-byte string literal not displayed */

The query executed by ChatMessages.

View Source 
const ClearNodeHistory_Operation = `
mutation ClearNodeHistory ($nodeRef: ID!) {
	clearNodeHistory(nodeRef: $nodeRef)
}
`

The mutation executed by ClearNodeHistory.

View Source 
const CloneMemory_Operation = `` /* 226-byte string literal not displayed */

The mutation executed by CloneMemory.

View Source 
const CloneNode_Operation = `` /* 272-byte string literal not displayed */

The mutation executed by CloneNode.

View Source 
const CompleteAssetUpload_Operation = `` /* 200-byte string literal not displayed */

The mutation executed by CompleteAssetUpload.

View Source 
const ConfirmTeamAttentionSwitchover_Operation = `` /* 193-byte string literal not displayed */

The mutation executed by ConfirmTeamAttentionSwitchover.

View Source 
const ConnectionGrants_Operation = `` /* 364-byte string literal not displayed */

The query executed by ConnectionGrants.

View Source 
const CreateAgentSchedule_Operation = `` /* 353-byte string literal not displayed */

The mutation executed by CreateAgentSchedule.

View Source 
const CreateAgentWebhook_Operation = `` /* 466-byte string literal not displayed */

The mutation executed by CreateAgentWebhook.

View Source 
const CreateAgent_Operation = `` /* 660-byte string literal not displayed */

The mutation executed by CreateAgent.

View Source 
const CreateAiServiceConfigWithEndpoint_Operation = `` /* 651-byte string literal not displayed */

The mutation executed by CreateAiServiceConfigWithEndpoint.

View Source 
const CreateAiServiceConfig_Operation = `` /* 554-byte string literal not displayed */

The mutation executed by CreateAiServiceConfig.

View Source 
const CreateApp_Operation = `` /* 313-byte string literal not displayed */

The mutation executed by CreateApp.

View Source 
const CreateAssetReferenceNode_Operation = `` /* 275-byte string literal not displayed */

The mutation executed by CreateAssetReferenceNode.

View Source 
const CreateChannelMessage_Operation = `` /* 411-byte string literal not displayed */

The mutation executed by CreateChannelMessage.

View Source 
const CreateChannel_Operation = `` /* 359-byte string literal not displayed */

The mutation executed by CreateChannel.

View Source 
const CreateConnectionGrant_Operation = `` /* 412-byte string literal not displayed */

The mutation executed by CreateConnectionGrant.

View Source 
const CreateEdge_Operation = `` /* 475-byte string literal not displayed */

The mutation executed by CreateEdge.

View Source 
const CreateMcpServer_Operation = `` /* 458-byte string literal not displayed */

The mutation executed by CreateMcpServer.

View Source 
const CreateMemoryConfigTemplate_Operation = `` /* 842-byte string literal not displayed */

The mutation executed by CreateMemoryConfigTemplate.

View Source 
const CreateMemoryDraft_Operation = `` /* 542-byte string literal not displayed */

The mutation executed by CreateMemoryDraft.

View Source 
const CreateMemoryInApp_Operation = `` /* 514-byte string literal not displayed */

The mutation executed by CreateMemoryInApp.

View Source 
const CreateMemoryShare_Operation = `` /* 307-byte string literal not displayed */

The mutation executed by CreateMemoryShare.

View Source 
const CreateMemorySubscription_Operation = `` /* 238-byte string literal not displayed */

The mutation executed by CreateMemorySubscription.

View Source 
const CreateMemory_Operation = `` /* 518-byte string literal not displayed */

The mutation executed by CreateMemory.

View Source 
const CreateNodeRoleRule_Operation = `` /* 721-byte string literal not displayed */

The mutation executed by CreateNodeRoleRule.

View Source 
const CreateNode_Operation = `` /* 169-byte string literal not displayed */

The mutation executed by CreateNode.

View Source 
const CreateObject_Operation = `` /* 213-byte string literal not displayed */

The mutation executed by CreateObject.

View Source 
const CreateOrganization_Operation = `` /* 227-byte string literal not displayed */

The mutation executed by CreateOrganization.

View Source 
const CreatePrincipalGrant_Operation = `` /* 412-byte string literal not displayed */

The mutation executed by CreatePrincipalGrant.

View Source 
const CreateRegisterEntry_Operation = `` /* 321-byte string literal not displayed */

The mutation executed by CreateRegisterEntry.

View Source 
const CreateReviewNode_Operation = `` /* 181-byte string literal not displayed */

The mutation executed by CreateReviewNode.

View Source 
const CreateScope_Operation = `` /* 384-byte string literal not displayed */

The mutation executed by CreateScope.

View Source 
const CreateSecret_Operation = `` /* 398-byte string literal not displayed */

The mutation executed by CreateSecret.

View Source 
const CreateSpecNode_Operation = `` /* 177-byte string literal not displayed */

The mutation executed by CreateSpecNode.

View Source 
const CreateTaskNode_Operation = `` /* 177-byte string literal not displayed */

The mutation executed by CreateTaskNode.

View Source 
const CreateTeamChatMessage_Operation = `` /* 390-byte string literal not displayed */

The mutation executed by CreateTeamChatMessage.

View Source 
const CreateTeamRole_Operation = `` /* 369-byte string literal not displayed */

The mutation executed by CreateTeamRole.

View Source 
const CreateUserApiKey_Operation = `` /* 250-byte string literal not displayed */

The mutation executed by CreateUserApiKey.

View Source 
const CreateUserInvitation_Operation = `` /* 565-byte string literal not displayed */

The mutation executed by CreateUserInvitation.

View Source 
const DeleteAgentSchedule_Operation = `
mutation DeleteAgentSchedule ($id: ID!) {
	deleteAgentSchedule(id: $id)
}
`

The mutation executed by DeleteAgentSchedule.

View Source 
const DeleteAgentWebhook_Operation = `
mutation DeleteAgentWebhook ($id: ID!) {
	deleteAgentWebhook(id: $id)
}
`

The mutation executed by DeleteAgentWebhook.

View Source 
const DeleteAgent_Operation = `
mutation DeleteAgent ($ref: ID!) {
	deleteAgent(ref: $ref)
}
`

The mutation executed by DeleteAgent.

View Source 
const DeleteAiServiceConfig_Operation = `
mutation DeleteAiServiceConfig ($id: ID!) {
	deleteAiServiceConfig(id: $id)
}
`

The mutation executed by DeleteAiServiceConfig.

View Source 
const DeleteApp_Operation = `
mutation DeleteApp ($ref: ID!) {
	deleteApp(ref: $ref)
}
`

The mutation executed by DeleteApp.

View Source 
const DeleteChannel_Operation = `
mutation DeleteChannel ($ref: ID!) {
	deleteChannel(ref: $ref)
}
`

The mutation executed by DeleteChannel.

View Source 
const DeleteEdge_Operation = `
mutation DeleteEdge ($edgeId: ID!) {
	deleteEdge(edgeRef: $edgeId)
}
`

The mutation executed by DeleteEdge.

View Source 
const DeleteMcpServer_Operation = `
mutation DeleteMcpServer ($ref: ID!) {
	deleteMcpServer(ref: $ref)
}
`

The mutation executed by DeleteMcpServer.

View Source 
const DeleteMemoryConfigTemplate_Operation = `` /* 154-byte string literal not displayed */

The mutation executed by DeleteMemoryConfigTemplate.

View Source 
const DeleteMemoryShare_Operation = `` /* 166-byte string literal not displayed */

The mutation executed by DeleteMemoryShare.

View Source 
const DeleteMemorySubscription_Operation = `` /* 145-byte string literal not displayed */

The mutation executed by DeleteMemorySubscription.

View Source 
const DeleteMemory_Operation = `
mutation DeleteMemory ($id: ID!) {
	deleteMemory(id: $id)
}
`

The mutation executed by DeleteMemory.

View Source 
const DeleteNodeRevision_Operation = `
mutation DeleteNodeRevision ($revisionId: ID!) {
	deleteNodeRevision(revisionId: $revisionId)
}
`

The mutation executed by DeleteNodeRevision.

View Source 
const DeleteNodeRoleRule_Operation = `` /* 138-byte string literal not displayed */

The mutation executed by DeleteNodeRoleRule.

View Source 
const DeleteNode_Operation = `` /* 145-byte string literal not displayed */

The mutation executed by DeleteNode.

View Source 
const DeleteObject_Operation = `
mutation DeleteObject ($ref: ID!, $hard: Boolean) {
	deleteObject(ref: $ref, hard: $hard)
}
`

The mutation executed by DeleteObject.

View Source 
const DeleteOrganization_Operation = `
mutation DeleteOrganization ($id: ID!) {
	deleteOrganization(id: $id)
}
`

The mutation executed by DeleteOrganization.

View Source 
const DeleteRegisterEntry_Operation = `
mutation DeleteRegisterEntry ($ref: ID!) {
	deleteRegisterEntry(ref: $ref)
}
`

The mutation executed by DeleteRegisterEntry.

View Source 
const DeleteScope_Operation = `
mutation DeleteScope ($ref: ID!) {
	deleteScope(ref: $ref)
}
`

The mutation executed by DeleteScope.

View Source 
const DeleteSecret_Operation = `
mutation DeleteSecret ($ref: ID!) {
	deleteSecret(ref: $ref)
}
`

The mutation executed by DeleteSecret.

View Source 
const DeleteTeamRole_Operation = `` /* 181-byte string literal not displayed */

The mutation executed by DeleteTeamRole.

View Source 
const DeleteWorker_Operation = `
mutation DeleteWorker ($workerRef: ID!) {
	deleteWorker(workerRef: $workerRef)
}
`

The mutation executed by DeleteWorker.

View Source 
const EffectiveAccess_Operation = `` /* 279-byte string literal not displayed */

The query executed by EffectiveAccess.

View Source 
const EncryptMemory_Operation = `` /* 156-byte string literal not displayed */

The mutation executed by EncryptMemory.

View Source 
const EndTeamSession_Operation = `` /* 372-byte string literal not displayed */

The mutation executed by EndTeamSession.

View Source 
const ExtractParentNodeToMemory_Operation = `` /* 301-byte string literal not displayed */

The mutation executed by ExtractParentNodeToMemory.

View Source 
const FindNodes_Operation = `` /* 589-byte string literal not displayed */

The query executed by FindNodes.

View Source 
const FindObjects_Operation = `` /* 288-byte string literal not displayed */

The query executed by FindObjects.

View Source 
const GetAgent_Operation = `` /* 267-byte string literal not displayed */

The query executed by GetAgent.

View Source 
const GetAppSharedMemory_Operation = `` /* 127-byte string literal not displayed */

The query executed by GetAppSharedMemory.

View Source 
const GetBoundSessionLiveness_Operation = `
query GetBoundSessionLiveness ($id: ID!) {
	session(id: $id) {
		id
		startedAt
		endedAt
		isLive
	}
}
`

The query executed by GetBoundSessionLiveness.

View Source 
const GetChannel_Operation = `` /* 325-byte string literal not displayed */

The query executed by GetChannel.

View Source 
const GetInvitation_Operation = `` /* 202-byte string literal not displayed */

The query executed by GetInvitation.

View Source 
const GetMemory_Operation = `` /* 264-byte string literal not displayed */

The query executed by GetMemory.

View Source 
const GetNodeRaw_Operation = `` /* 499-byte string literal not displayed */

The query executed by GetNodeRaw.

View Source 
const GetNode_Operation = `` /* 485-byte string literal not displayed */

The query executed by GetNode.

View Source 
const GetObject_Operation = `
query GetObject ($ref: ID!) {
	object(ref: $ref)
}
`

The query executed by GetObject.

View Source 
const GetOrganization_Operation = `` /* 182-byte string literal not displayed */

The query executed by GetOrganization.

View Source 
const GetRegisterEntry_Operation = `` /* 281-byte string literal not displayed */

The query executed by GetRegisterEntry.

View Source 
const GetScope_Operation = `` /* 352-byte string literal not displayed */

The query executed by GetScope.

View Source 
const GetSpecNodeForEdit_Operation = `` /* 185-byte string literal not displayed */

The query executed by GetSpecNodeForEdit.

View Source 
const GetSpecNodeRaw_Operation = `` /* 156-byte string literal not displayed */

The query executed by GetSpecNodeRaw.

View Source 
const GetTeamSession_Operation = `` /* 292-byte string literal not displayed */

The query executed by GetTeamSession.

View Source 
const GetUser_Operation = `` /* 220-byte string literal not displayed */

The query executed by GetUser.

View Source 
const GetWorkerContinuity_Operation = `` /* 219-byte string literal not displayed */

The query executed by GetWorkerContinuity.

View Source 
const GetWorker_Operation = `` /* 303-byte string literal not displayed */

The query executed by GetWorker.

View Source 
const ImportNode_Operation = `` /* 172-byte string literal not displayed */

The mutation executed by ImportNode.

View Source 
const InstallAgentIntoApp_Operation = `` /* 306-byte string literal not displayed */

The mutation executed by InstallAgentIntoApp.

View Source 
const LinkMemoryToUser_Operation = `` /* 303-byte string literal not displayed */

The mutation executed by LinkMemoryToUser.

View Source 
const MarkOwnTeamChatRead_Operation = `` /* 238-byte string literal not displayed */

The mutation executed by MarkOwnTeamChatRead.

View Source 
const McpServerTools_Operation = `
query McpServerTools ($ref: ID!) {
	mcpServerTools(ref: $ref) {
		name
		description
		runToolName
		inputSchema
	}
}
`

The query executed by McpServerTools.

View Source 
const McpServer_Operation = `` /* 219-byte string literal not displayed */

The query executed by McpServer.

View Source 
const McpServers_Operation = `` /* 308-byte string literal not displayed */

The query executed by McpServers.

View Source 
const Me_Operation = `
query Me {
	me {
		id
		name
		email
		handle
		githubUsername
		roles
	}
}
`

The query executed by Me.

View Source 
const MemoriesSharedWithMe_Operation = `` /* 474-byte string literal not displayed */

The query executed by MemoriesSharedWithMe.

View Source 
const Memories_Operation = `` /* 282-byte string literal not displayed */

The query executed by Memories.

View Source 
const MemoryAssets_Operation = `` /* 457-byte string literal not displayed */

The query executed by MemoryAssets.

View Source 
const MemoryConfigTemplate_Operation = `` /* 520-byte string literal not displayed */

The query executed by MemoryConfigTemplate.

View Source 
const MemoryConfigTemplates_Operation = `` /* 636-byte string literal not displayed */

The query executed by MemoryConfigTemplates.

View Source 
const MemoryConfig_Operation = `` /* 571-byte string literal not displayed */

The query executed by MemoryConfig.

View Source 
const MemoryMembers_Operation = `` /* 200-byte string literal not displayed */

The query executed by MemoryMembers.

View Source 
const MemoryShares_Operation = `` /* 201-byte string literal not displayed */

The query executed by MemoryShares.

View Source 
const MemorySubscriptions_Operation = `` /* 162-byte string literal not displayed */

The query executed by MemorySubscriptions.

View Source 
const MergeNodes_Operation = `` /* 163-byte string literal not displayed */

The mutation executed by MergeNodes.

View Source 
const MergeUsers_Operation = `` /* 286-byte string literal not displayed */

The mutation executed by MergeUsers.

View Source 
const MintActionTickets_Operation = `
mutation MintActionTickets ($input: MintActionTicketsInput!) {
	mintActionTickets(input: $input)
}
`

The mutation executed by MintActionTickets.

View Source 
const MintMemoryNodes_Operation = `` /* 413-byte string literal not displayed */

The mutation executed by MintMemoryNodes.

View Source 
const MintSpecCorpus_Operation = `` /* 386-byte string literal not displayed */

The mutation executed by MintSpecCorpus.

View Source 
const MoveNode_Operation = `` /* 270-byte string literal not displayed */

The mutation executed by MoveNode.

View Source 
const MyUserApiKeys_Operation = `` /* 180-byte string literal not displayed */

The query executed by MyUserApiKeys.

View Source 
const NodeBatch_Operation = `` /* 703-byte string literal not displayed */

The query executed by NodeBatch.

View Source 
const NodeExportMeta_Operation = `
query NodeExportMeta ($ref: ID!) {
	node(ref: $ref) {
		loc
		name
		memoryId
		memory {
			urn
		}
	}
}
`

The query executed by NodeExportMeta.

View Source 
const NodeExport_Operation = `` /* 162-byte string literal not displayed */

The query executed by NodeExport.

View Source 
const NodeLiveRevisionsApproved_Operation = `` /* 926-byte string literal not displayed */

The query executed by NodeLiveRevisionsApproved.

View Source 
const NodeLiveRevisionsMinted_Operation = `` /* 1104-byte string literal not displayed */

The query executed by NodeLiveRevisionsMinted.

View Source 
const NodeLiveRevisionsStamped_Operation = `` /* 636-byte string literal not displayed */

The query executed by NodeLiveRevisionsStamped.

View Source 
const NodeLiveRevisions_Operation = `` /* 214-byte string literal not displayed */

The query executed by NodeLiveRevisions.

View Source 
const NodeRevisionStamped_Operation = `` /* 708-byte string literal not displayed */

The query executed by NodeRevisionStamped.

View Source 
const NodeRevision_Operation = `` /* 292-byte string literal not displayed */

The query executed by NodeRevision.

View Source 
const NodeRevisionsStamped_Operation = `` /* 719-byte string literal not displayed */

The query executed by NodeRevisionsStamped.

View Source 
const NodeRevisions_Operation = `` /* 303-byte string literal not displayed */

The query executed by NodeRevisions.

View Source 
const OrgMembers_Operation = `` /* 296-byte string literal not displayed */

The query executed by OrgMembers.

View Source 
const Organizations_Operation = `` /* 287-byte string literal not displayed */

The query executed by Organizations.

View Source 
const PrincipalGrants_Operation = `` /* 395-byte string literal not displayed */

The query executed by PrincipalGrants.

View Source 
const PublicAgents_Operation = `` /* 383-byte string literal not displayed */

The query executed by PublicAgents.

View Source 
const PublicOrganization_Operation = `` /* 310-byte string literal not displayed */

The query executed by PublicOrganization.

View Source 
const RecordTeamWorkLegacy_Operation = `` /* 445-byte string literal not displayed */

The mutation executed by RecordTeamWorkLegacy.

View Source 
const RecordTeamWork_Operation = `` /* 465-byte string literal not displayed */

The mutation executed by RecordTeamWork.

View Source 
const RegisterEntries_Operation = `` /* 416-byte string literal not displayed */

The query executed by RegisterEntries.

View Source 
const ReleaseWorker_Operation = `` /* 548-byte string literal not displayed */

The mutation executed by ReleaseWorker.

View Source 
const RemoveMemoryMember_Operation = `` /* 161-byte string literal not displayed */

The mutation executed by RemoveMemoryMember.

View Source 
const RemoveOrgMember_Operation = `
mutation RemoveOrgMember ($orgId: ID!, $userId: ID!) {
	removeOrgMember(orgId: $orgId, userId: $userId)
}
`

The mutation executed by RemoveOrgMember.

View Source 
const RenumberSpec_Operation = `` /* 391-byte string literal not displayed */

The mutation executed by RenumberSpec.

View Source 
const ReserveSpecCitation_Operation = `` /* 196-byte string literal not displayed */

The mutation executed by ReserveSpecCitation.

View Source 
const ResolveAiServiceConfigsWithEndpoint_Operation = `` /* 383-byte string literal not displayed */

The query executed by ResolveAiServiceConfigsWithEndpoint.

View Source 
const ResolveAiServiceConfigs_Operation = `` /* 256-byte string literal not displayed */

The query executed by ResolveAiServiceConfigs.

View Source 
const ResolveUrn_Operation = `
query ResolveUrn ($urn: String!) {
	resolveUrn(urn: $urn) {
		id
		kind
		memoryId
	}
}
`

The query executed by ResolveUrn.

View Source 
const RestoreAsset_Operation = `
mutation RestoreAsset ($assetId: ID!) {
	restoreAsset(assetId: $assetId) {
		id
		urn
		filename
		deletedAt
	}
}
`

The mutation executed by RestoreAsset.

View Source 
const RestoreNodeRevision_Operation = `` /* 197-byte string literal not displayed */

The mutation executed by RestoreNodeRevision.

View Source 
const RetireWorker_Operation = `` /* 333-byte string literal not displayed */

The mutation executed by RetireWorker.

View Source 
const RevokeConnectionGrant_Operation = `
mutation RevokeConnectionGrant ($ref: ID!) {
	revokeConnectionGrant(ref: $ref)
}
`

The mutation executed by RevokeConnectionGrant.

View Source 
const RevokePrincipalGrant_Operation = `
mutation RevokePrincipalGrant ($ref: ID!) {
	revokePrincipalGrant(ref: $ref)
}
`

The mutation executed by RevokePrincipalGrant.

View Source 
const RevokeUserApiKey_Operation = `` /* 209-byte string literal not displayed */

The mutation executed by RevokeUserApiKey.

View Source 
const RotateAgentWebhook_Operation = `` /* 436-byte string literal not displayed */

The mutation executed by RotateAgentWebhook.

View Source 
const RunTask_Operation = `` /* 170-byte string literal not displayed */

The mutation executed by RunTask.

View Source 
const ScopeExplain_Operation = `` /* 476-byte string literal not displayed */

The query executed by ScopeExplain.

View Source 
const Scopes_Operation = `` /* 339-byte string literal not displayed */

The query executed by Scopes.

View Source 
const SearchNodes_Operation = `` /* 765-byte string literal not displayed */

The query executed by SearchNodes.

View Source 
const SearchReplaceInNodes_Operation = `` /* 273-byte string literal not displayed */

The mutation executed by SearchReplaceInNodes.

View Source 
const SearchReplaceInSpecNodes_Operation = `` /* 374-byte string literal not displayed */

The mutation executed by SearchReplaceInSpecNodes.

View Source 
const SearchUsers_Operation = `` /* 325-byte string literal not displayed */

The query executed by SearchUsers.

View Source 
const Secrets_Operation = `` /* 341-byte string literal not displayed */

The query executed by Secrets.

View Source 
const SelectedSkillFilePlan_Operation = `` /* 588-byte string literal not displayed */

The query executed by SelectedSkillFilePlan.

View Source 
const ServerInfo_Operation = `
query ServerInfo {
	serverInfo {
		version
		baseUrl
	}
}
`

The query executed by ServerInfo.

View Source 
const SkillExportPlan_Operation = `` /* 681-byte string literal not displayed */

The query executed by SkillExportPlan.

View Source 
const SkillPlan_Operation = `` /* 319-byte string literal not displayed */

The query executed by SkillPlan.

View Source 
const SoftDeleteAsset_Operation = `
mutation SoftDeleteAsset ($assetId: ID!) {
	softDeleteAsset(assetId: $assetId) {
		id
		urn
		filename
		deletedAt
	}
}
`

The mutation executed by SoftDeleteAsset.

View Source 
const SpecBacklinks_Operation = `` /* 173-byte string literal not displayed */

The query executed by SpecBacklinks.

View Source 
const SpecCorpusState_Operation = `
query SpecCorpusState ($ref: ID!) {
	memory(ref: $ref) {
		id
		urn
		corpusState
		corpusMintedAt
	}
}
`

The query executed by SpecCorpusState.

View Source 
const SpecPlaceholderScan_Operation = `` /* 233-byte string literal not displayed */

The query executed by SpecPlaceholderScan.

View Source 
const SpecUnresolvedReferences_Operation = `` /* 178-byte string literal not displayed */

The query executed by SpecUnresolvedReferences.

View Source 
const StartImpersonation_Operation = `` /* 296-byte string literal not displayed */

The mutation executed by StartImpersonation.

View Source 
const StartTeamSession_Operation = `` /* 321-byte string literal not displayed */

The mutation executed by StartTeamSession.

View Source 
const StopImpersonation_Operation = `
mutation StopImpersonation ($id: ID) {
	stopImpersonation(id: $id) {
		id
		endedAt
	}
}
`

The mutation executed by StopImpersonation.

View Source 
const TeamAppIdentity_Operation = `
query TeamAppIdentity ($appRef: ID!) {
	app(ref: $appRef) {
		id
		urn
		name
	}
}
`

The query executed by TeamAppIdentity.

View Source 
const TeamAttentionPage_Operation = `` /* 321-byte string literal not displayed */

The query executed by TeamAttentionPage.

View Source 
const TeamAttentionPreviewPage_Operation = `` /* 307-byte string literal not displayed */

The query executed by TeamAttentionPreviewPage.

View Source 
const TeamAttentionSwitchoverPreview_Operation = `` /* 269-byte string literal not displayed */

The query executed by TeamAttentionSwitchoverPreview.

View Source 
const TeamAttention_Operation = `` /* 266-byte string literal not displayed */

The query executed by TeamAttention.

View Source 
const TeamChatMessages_Operation = `` /* 467-byte string literal not displayed */

The query executed by TeamChatMessages.

View Source 
const TeamDefaultChannel_Operation = `
query TeamDefaultChannel ($appRef: ID!) {
	app(ref: $appRef) {
		id
		defaultChannel {
			id
		}
	}
}
`

The query executed by TeamDefaultChannel.

View Source 
const TeamMemoryApp_Operation = `
query TeamMemoryApp ($ref: ID!) {
	memory(ref: $ref) {
		id
		appId
	}
}
`

The query executed by TeamMemoryApp.

View Source 
const TeamRoles_Operation = `` /* 360-byte string literal not displayed */

The query executed by TeamRoles.

View Source 
const TeamSessions_Operation = `` /* 402-byte string literal not displayed */

The query executed by TeamSessions.

View Source 
const TeamWorkItemsLegacy_Operation = `` /* 451-byte string literal not displayed */

The query executed by TeamWorkItemsLegacy.

View Source 
const TeamWorkItems_Operation = `` /* 440-byte string literal not displayed */

The query executed by TeamWorkItems.

View Source 
const TransferMemoryOwnership_Operation = `` /* 574-byte string literal not displayed */

The mutation executed by TransferMemoryOwnership.

View Source 
const TriggerAppRun_Operation = `` /* 392-byte string literal not displayed */

The mutation executed by TriggerAppRun.

View Source 
const UninstallAgentFromApp_Operation = `` /* 151-byte string literal not displayed */

The mutation executed by UninstallAgentFromApp.

View Source 
const UnlockNodeRoleRule_Operation = `` /* 716-byte string literal not displayed */

The mutation executed by UnlockNodeRoleRule.

View Source 
const UpdateAgentSchedule_Operation = `` /* 372-byte string literal not displayed */

The mutation executed by UpdateAgentSchedule.

View Source 
const UpdateAgent_Operation = `` /* 679-byte string literal not displayed */

The mutation executed by UpdateAgent.

View Source 
const UpdateAiServiceConfigWithEndpoint_Operation = `` /* 578-byte string literal not displayed */

The mutation executed by UpdateAiServiceConfigWithEndpoint.

View Source 
const UpdateAiServiceConfig_Operation = `` /* 481-byte string literal not displayed */

The mutation executed by UpdateAiServiceConfig.

View Source 
const UpdateChannel_Operation = `` /* 381-byte string literal not displayed */

The mutation executed by UpdateChannel.

View Source 
const UpdateEdge_Operation = `` /* 426-byte string literal not displayed */

The mutation executed by UpdateEdge.

View Source 
const UpdateMcpServer_Operation = `` /* 471-byte string literal not displayed */

The mutation executed by UpdateMcpServer.

View Source 
const UpdateMemoryConfigTemplateClearingDescription_Operation = `` /* 926-byte string literal not displayed */

The mutation executed by UpdateMemoryConfigTemplateClearingDescription.

View Source 
const UpdateMemoryConfigTemplate_Operation = `` /* 823-byte string literal not displayed */

The mutation executed by UpdateMemoryConfigTemplate.

View Source 
const UpdateMemoryMemberRole_Operation = `` /* 314-byte string literal not displayed */

The mutation executed by UpdateMemoryMemberRole.

View Source 
const UpdateMemoryShareRole_Operation = `` /* 315-byte string literal not displayed */

The mutation executed by UpdateMemoryShareRole.

View Source 
const UpdateMemorySubscription_Operation = `` /* 238-byte string literal not displayed */

The mutation executed by UpdateMemorySubscription.

View Source 
const UpdateMemory_Operation = `` /* 545-byte string literal not displayed */

The mutation executed by UpdateMemory.

View Source 
const UpdateMyProfile_Operation = `` /* 313-byte string literal not displayed */

The mutation executed by UpdateMyProfile.

View Source 
const UpdateNodeData_Operation = `` /* 225-byte string literal not displayed */

The mutation executed by UpdateNodeData.

View Source 
const UpdateNodeRevision_Operation = `` /* 337-byte string literal not displayed */

The mutation executed by UpdateNodeRevision.

View Source 
const UpdateNodeRoleRuleClearingValidateBy_Operation = `` /* 1071-byte string literal not displayed */

The mutation executed by UpdateNodeRoleRuleClearingValidateBy.

View Source 
const UpdateNodeRoleRule_Operation = `` /* 765-byte string literal not displayed */

The mutation executed by UpdateNodeRoleRule.

View Source 
const UpdateNode_Operation = `` /* 169-byte string literal not displayed */

The mutation executed by UpdateNode.

View Source 
const UpdateObject_Operation = `` /* 131-byte string literal not displayed */

The mutation executed by UpdateObject.

View Source 
const UpdateOrgMember_Operation = `` /* 332-byte string literal not displayed */

The mutation executed by UpdateOrgMember.

View Source 
const UpdateOrganization_Operation = `` /* 318-byte string literal not displayed */

The mutation executed by UpdateOrganization.

View Source 
const UpdateRegisterEntry_Operation = `` /* 343-byte string literal not displayed */

The mutation executed by UpdateRegisterEntry.

View Source 
const UpdateReviewNode_Operation = `` /* 181-byte string literal not displayed */

The mutation executed by UpdateReviewNode.

View Source 
const UpdateScope_Operation = `` /* 406-byte string literal not displayed */

The mutation executed by UpdateScope.

View Source 
const UpdateSpecNode_Operation = `` /* 198-byte string literal not displayed */

The mutation executed by UpdateSpecNode.

View Source 
const UpdateTaskNode_Operation = `` /* 177-byte string literal not displayed */

The mutation executed by UpdateTaskNode.

View Source 
const UpdateTeamCollections_Operation = `` /* 131-byte string literal not displayed */

The mutation executed by UpdateTeamCollections.

View Source 
const UpdateTeamRoleMeta_Operation = `` /* 373-byte string literal not displayed */

The mutation executed by UpdateTeamRoleMeta.

View Source 
const UpdateTeamSession_Operation = `` /* 375-byte string literal not displayed */

The mutation executed by UpdateTeamSession.

View Source 
const UpdateUserRoles_Operation = `` /* 284-byte string literal not displayed */

The mutation executed by UpdateUserRoles.

View Source 
const UpdateWorker_Operation = `` /* 391-byte string literal not displayed */

The mutation executed by UpdateWorker.

View Source 
const ValidateMemory_Operation = `` /* 283-byte string literal not displayed */

The query executed by ValidateMemory.

View Source 
const VerifyNode_Operation = `` /* 161-byte string literal not displayed */

The query executed by VerifyNode.

View Source 
const WorkersRoster_Operation = `` /* 462-byte string literal not displayed */

The query executed by WorkersRoster.

View Source 
const Workers_Operation = `` /* 452-byte string literal not displayed */

The query executed by Workers.

Variables

View Source 
var AllAccessSource = []AccessSource{
	AccessSourceAgentSubscription,
	AccessSourceAiconfigOwner,
	AccessSourceAppMember,
	AccessSourceMemoryMember,
	AccessSourceMemoryPrincipal,
	AccessSourceMemoryShare,
	AccessSourceNodeInherited,
	AccessSourceOrgRole,
	AccessSourcePlatformRole,
	AccessSourcePrincipalGrant,
	AccessSourcePublicVisibility,
}
View Source 
var AllAgentType = []AgentType{
	AgentTypeAssistant,
	AgentTypeChatbot,
}
View Source 
var AllAgentVisibility = []AgentVisibility{
	AgentVisibilityOrganization,
	AgentVisibilityPersonal,
	AgentVisibilityPublic,
}
View Source 
var AllAiConfigOwnerType = []AiConfigOwnerType{
	AiConfigOwnerTypeAgent,
	AiConfigOwnerTypeApp,
	AiConfigOwnerTypeHadronServer,
	AiConfigOwnerTypeOrganization,
}
View Source 
var AllAppRunStatus = []AppRunStatus{
	AppRunStatusCancelled,
	AppRunStatusCompleted,
	AppRunStatusFailed,
	AppRunStatusPending,
	AppRunStatusRunning,
	AppRunStatusTimedOut,
}
View Source 
var AllAppRunTriggerKind = []AppRunTriggerKind{
	AppRunTriggerKindIntegration,
	AppRunTriggerKindManual,
	AppRunTriggerKindSchedule,
	AppRunTriggerKindSpawn,
	AppRunTriggerKindWebhook,
}
View Source 
var AllAppType = []AppType{
	AppTypeAgent,
	AppTypeAutomation,
	AppTypeChatbot,
	AppTypeCloud,
	AppTypeIot,
	AppTypeWorkstation,
}
View Source 
var AllAssetScanStatus = []AssetScanStatus{
	AssetScanStatusBlocked,
	AssetScanStatusClean,
	AssetScanStatusPending,
}
View Source 
var AllChannelKind = []ChannelKind{
	ChannelKindChat,
}
View Source 
var AllContentValidator = []ContentValidator{
	ContentValidatorAgent,
	ContentValidatorPlatform,
}
View Source 
var AllCorpusState = []CorpusState{
	CorpusStateDraft,
	CorpusStateMinted,
}
View Source 
var AllFindNodesMode = []FindNodesMode{
	FindNodesModeHybrid,
	FindNodesModeKeyword,
	FindNodesModeRegex,
	FindNodesModeVector,
}
View Source 
var AllImportNodeStatus = []ImportNodeStatus{
	ImportNodeStatusFetchPending,
	ImportNodeStatusStored,
}
View Source 
var AllMemoryClass = []MemoryClass{
	MemoryClassApp,
	MemoryClassGroup,
	MemoryClassKnowledge,
	MemoryClassPersonal,
	MemoryClassPrivate,
	MemoryClassSystem,
}
View Source 
var AllMemoryConfigApplyOutcome = []MemoryConfigApplyOutcome{
	MemoryConfigApplyOutcomeApplied,
	MemoryConfigApplyOutcomeReplaced,
	MemoryConfigApplyOutcomeSkippedConflict,
	MemoryConfigApplyOutcomeSkippedLocked,
}
View Source 
var AllMemoryConfigTemplateOwnerType = []MemoryConfigTemplateOwnerType{
	MemoryConfigTemplateOwnerTypeApp,
	MemoryConfigTemplateOwnerTypeHadronServer,
	MemoryConfigTemplateOwnerTypeOrganization,
	MemoryConfigTemplateOwnerTypeUser,
}
View Source 
var AllMemoryMemberRole = []MemoryMemberRole{
	MemoryMemberRoleOwner,
	MemoryMemberRoleReader,
	MemoryMemberRoleWriter,
}
View Source 
var AllMemoryShareRole = []MemoryShareRole{
	MemoryShareRoleReader,
	MemoryShareRoleWriter,
}
View Source 
var AllMemoryTransferHandling = []MemoryTransferHandling{
	MemoryTransferHandlingCarry,
	MemoryTransferHandlingCreate,
	MemoryTransferHandlingRefuse,
	MemoryTransferHandlingRemove,
}
View Source 
var AllMemoryValidationCheck = []MemoryValidationCheck{
	MemoryValidationCheckBrokenRef,
	MemoryValidationCheckEmbedFailed,
	MemoryValidationCheckSchema,
	MemoryValidationCheckSparse,
	MemoryValidationCheckStaleAbstract,
}
View Source 
var AllMemoryVisibility = []MemoryVisibility{
	MemoryVisibilityGroup,
	MemoryVisibilityOrganization,
	MemoryVisibilityPublic,
}
View Source 
var AllNodeApprovalState = []NodeApprovalState{
	NodeApprovalStateApproved,
	NodeApprovalStateNotApproved,
	NodeApprovalStateSuperseded,
}
View Source 
var AllNodeAuthorshipKind = []NodeAuthorshipKind{
	NodeAuthorshipKindHuman,
	NodeAuthorshipKindTask,
}
View Source 
var AllNodeContentValidationOutcome = []NodeContentValidationOutcome{
	NodeContentValidationOutcomeError,
	NodeContentValidationOutcomeFail,
	NodeContentValidationOutcomePass,
}
View Source 
var AllNodeContentValidationState = []NodeContentValidationState{
	NodeContentValidationStateError,
	NodeContentValidationStateFail,
	NodeContentValidationStatePass,
	NodeContentValidationStateStale,
	NodeContentValidationStateUnvalidated,
}
View Source 
var AllNodeExportFormat = []NodeExportFormat{
	NodeExportFormatJson,
	NodeExportFormatMd,
	NodeExportFormatPdf,
}
View Source 
var AllNodeIntegrityState = []NodeIntegrityState{
	NodeIntegrityStateIntact,
	NodeIntegrityStateNotApproved,
	NodeIntegrityStateSuperseded,
	NodeIntegrityStateTampered,
}
View Source 
var AllNodeMergeField = []NodeMergeField{
	NodeMergeFieldAbstract,
	NodeMergeFieldContent,
	NodeMergeFieldData,
	NodeMergeFieldDescription,
	NodeMergeFieldEdges,
	NodeMergeFieldProperties,
	NodeMergeFieldTags,
}
View Source 
var AllNodeRoleRuleRefState = []NodeRoleRuleRefState{
	NodeRoleRuleRefStateBroken,
	NodeRoleRuleRefStateNone,
	NodeRoleRuleRefStateOk,
	NodeRoleRuleRefStateUnreadable,
}
View Source 
var AllNodeRoleWriters = []NodeRoleWriters{
	NodeRoleWritersAdmin,
	NodeRoleWritersAll,
	NodeRoleWritersOwner,
}
View Source 
var AllNodeSort = []NodeSort{
	NodeSortLoc,
	NodeSortRelevance,
	NodeSortSeq,
	NodeSortUpdatedat,
}
View Source 
var AllNodeTextField = []NodeTextField{
	NodeTextFieldAbstract,
	NodeTextFieldAlias,
	NodeTextFieldContent,
	NodeTextFieldDescription,
	NodeTextFieldName,
	NodeTextFieldTags,
}
View Source 
var AllPrincipalType = []PrincipalType{
	PrincipalTypeAgent,
	PrincipalTypeApp,
	PrincipalTypeUser,
}
View Source 
var AllRegisterOwnerType = []RegisterOwnerType{
	RegisterOwnerTypeApp,
	RegisterOwnerTypeOrganization,
}
View Source 
var AllRegisterRole = []RegisterRole{
	RegisterRoleBoth,
	RegisterRolePost,
	RegisterRoleWatch,
}
View Source 
var AllRole = []Role{
	RoleAdmin,
	RoleContributor,
	RoleOwner,
	RoleReader,
}
View Source 
var AllScopeOwnerType = []ScopeOwnerType{
	ScopeOwnerTypeAgent,
	ScopeOwnerTypeApp,
	ScopeOwnerTypeOrganization,
}
View Source 
var AllSearchReplaceSkipReason = []SearchReplaceSkipReason{
	SearchReplaceSkipReasonOtherGovernedKind,
	SearchReplaceSkipReasonProtectedAddress,
}
View Source 
var AllSkillExportAction = []SkillExportAction{
	SkillExportActionFail,
	SkillExportActionMove,
	SkillExportActionRefuse,
	SkillExportActionRemove,
	SkillExportActionSkip,
	SkillExportActionWrite,
}
View Source 
var AllSkillPlanIntent = []SkillPlanIntent{
	SkillPlanIntentExport,
	SkillPlanIntentLint,
	SkillPlanIntentStatus,
}
View Source 
var AllSpecMintFindingKind = []SpecMintFindingKind{
	SpecMintFindingKindCitesUnminted,
	SpecMintFindingKindLint,
	SpecMintFindingKindNotApproved,
	SpecMintFindingKindPlaceholder,
	SpecMintFindingKindStaleAbstract,
	SpecMintFindingKindTampered,
	SpecMintFindingKindUnresolvedReference,
}
View Source 
var AllSpecReferenceKind = []SpecReferenceKind{
	SpecReferenceKindEdge,
	SpecReferenceKindUrn,
}
View Source 
var AllSpecReferenceProblem = []SpecReferenceProblem{
	SpecReferenceProblemMissing,
	SpecReferenceProblemPlaceholder,
}
View Source 
var AllSpecRewriteStatus = []SpecRewriteStatus{
	SpecRewriteStatusFailed,
	SpecRewriteStatusPlanned,
	SpecRewriteStatusRewritten,
	SpecRewriteStatusUnchanged,
}
View Source 
var AllSpecTextField = []SpecTextField{
	SpecTextFieldAbstract,
	SpecTextFieldContent,
}
View Source 
var AllSyncStatus = []SyncStatus{
	SyncStatusError,
	SyncStatusOk,
	SyncStatusPending,
	SyncStatusSyncing,
}
View Source 
var AllUploadIntent = []UploadIntent{
	UploadIntentAgentRequest,
	UploadIntentUser,
}
View Source 
var AllWorkerContinuityStatus = []WorkerContinuityStatus{
	WorkerContinuityStatusCurrent,
	WorkerContinuityStatusFirstStint,
	WorkerContinuityStatusMissing,
}

Functions

This section is empty.

Types

type AcceptInvitationResponse added in v0.7.0 

type AcceptInvitationResponse struct {
	AcceptInvitation bool `json:"acceptInvitation"`
}

AcceptInvitationResponse is returned by AcceptInvitation on success.

func AcceptInvitation added in v0.7.0 

func AcceptInvitation(
	ctx_ context.Context,
	client_ graphql.Client,
	slug string,
) (data_ *AcceptInvitationResponse, err_ error)

func (*AcceptInvitationResponse) GetAcceptInvitation added in v0.7.0 

func (v *AcceptInvitationResponse) GetAcceptInvitation() bool

GetAcceptInvitation returns AcceptInvitationResponse.AcceptInvitation, and is useful for accessing the field via an interface.

type AccessSource added in v0.4.0 

type AccessSource string

issue #323: where a single grant in an EffectiveAccess result comes from. 

const (
	// active AgentSubscription, or an org-level AgentOrgGrant the user inherits.
	AccessSourceAgentSubscription AccessSource = "AGENT_SUBSCRIPTION"
	// admin of the AI config's owning entity.
	AccessSourceAiconfigOwner AccessSource = "AICONFIG_OWNER"
	// AppMember row.
	AccessSourceAppMember AccessSource = "APP_MEMBER"
	// group-class team membership row (MemoryMember).
	AccessSourceMemoryMember AccessSource = "MEMORY_MEMBER"
	// personal/private memory owner (Memory.userId).
	AccessSourceMemoryPrincipal AccessSource = "MEMORY_PRINCIPAL"
	// personal-class cross-user grant (MemoryShare).
	AccessSourceMemoryShare AccessSource = "MEMORY_SHARE"
	// node inherits its memory's access.
	AccessSourceNodeInherited AccessSource = "NODE_INHERITED"
	// ADMIN/OWNER (or, for org-readable knowledge, any Role) of the owning org.
	AccessSourceOrgRole AccessSource = "ORG_ROLE"
	// Platform ADMIN/OWNER.
	AccessSourcePlatformRole AccessSource = "PLATFORM_ROLE"
	// individual action grant (PrincipalGrant, cor:acl:040:06) - clone/delete capabilities on top of the role bundle.
	AccessSourcePrincipalGrant AccessSource = "PRINCIPAL_GRANT"
	// resource is publicly / universally visible.
	AccessSourcePublicVisibility AccessSource = "PUBLIC_VISIBILITY"
)

type ActionTicketFields added in v0.6.0 

type ActionTicketFields struct {
	Id              string  `json:"id"`
	OrganizationId  string  `json:"organizationId"`
	AppId           *string `json:"appId"`
	Action          string  `json:"action"`
	MintedBy        string  `json:"mintedBy"`
	Note            *string `json:"note"`
	ConsumedByRunId *string `json:"consumedByRunId"`
	ConsumedAt      *string `json:"consumedAt"`
	ExpiresAt       *string `json:"expiresAt"`
	CreatedAt       string  `json:"createdAt"`
}

ActionTicketFields includes the GraphQL fields of ActionTicket requested by the fragment ActionTicketFields. The GraphQL type's documentation follows.

One consumable ticket in the org ledger (cor:acl:050:04 tier 2).

func (*ActionTicketFields) GetAction added in v0.6.0 

func (v *ActionTicketFields) GetAction() string

GetAction returns ActionTicketFields.Action, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetAppId added in v0.6.0 

func (v *ActionTicketFields) GetAppId() *string

GetAppId returns ActionTicketFields.AppId, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetConsumedAt added in v0.6.0 

func (v *ActionTicketFields) GetConsumedAt() *string

GetConsumedAt returns ActionTicketFields.ConsumedAt, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetConsumedByRunId added in v0.6.0 

func (v *ActionTicketFields) GetConsumedByRunId() *string

GetConsumedByRunId returns ActionTicketFields.ConsumedByRunId, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetCreatedAt added in v0.6.0 

func (v *ActionTicketFields) GetCreatedAt() string

GetCreatedAt returns ActionTicketFields.CreatedAt, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetExpiresAt added in v0.6.0 

func (v *ActionTicketFields) GetExpiresAt() *string

GetExpiresAt returns ActionTicketFields.ExpiresAt, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetId added in v0.6.0 

func (v *ActionTicketFields) GetId() string

GetId returns ActionTicketFields.Id, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetMintedBy added in v0.6.0 

func (v *ActionTicketFields) GetMintedBy() string

GetMintedBy returns ActionTicketFields.MintedBy, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetNote added in v0.6.0 

func (v *ActionTicketFields) GetNote() *string

GetNote returns ActionTicketFields.Note, and is useful for accessing the field via an interface.

func (*ActionTicketFields) GetOrganizationId added in v0.6.0 

func (v *ActionTicketFields) GetOrganizationId() string

GetOrganizationId returns ActionTicketFields.OrganizationId, and is useful for accessing the field via an interface.

type ActionTicketsActionTicketsActionTicketsPage added in v0.6.0 

type ActionTicketsActionTicketsActionTicketsPage struct {
	Total int                                                             `json:"total"`
	Items []*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket `json:"items"`
}

ActionTicketsActionTicketsActionTicketsPage includes the requested fields of the GraphQL type ActionTicketsPage.

func (*ActionTicketsActionTicketsActionTicketsPage) GetItems added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPage) GetItems() []*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket

GetItems returns ActionTicketsActionTicketsActionTicketsPage.Items, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPage) GetTotal added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPage) GetTotal() int

GetTotal returns ActionTicketsActionTicketsActionTicketsPage.Total, and is useful for accessing the field via an interface.

type ActionTicketsActionTicketsActionTicketsPageItemsActionTicket added in v0.6.0 

type ActionTicketsActionTicketsActionTicketsPageItemsActionTicket struct {
	ActionTicketFields `json:"-"`
}

ActionTicketsActionTicketsActionTicketsPageItemsActionTicket includes the requested fields of the GraphQL type ActionTicket. The GraphQL type's documentation follows.

One consumable ticket in the org ledger (cor:acl:050:04 tier 2).

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetAction added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetAction() string

GetAction returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.Action, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetAppId added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetAppId() *string

GetAppId returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.AppId, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetConsumedAt added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetConsumedAt() *string

GetConsumedAt returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.ConsumedAt, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetConsumedByRunId added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetConsumedByRunId() *string

GetConsumedByRunId returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.ConsumedByRunId, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetCreatedAt added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetCreatedAt() string

GetCreatedAt returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.CreatedAt, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetExpiresAt added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetExpiresAt() *string

GetExpiresAt returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.ExpiresAt, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetId added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetId() string

GetId returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.Id, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetMintedBy added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetMintedBy() string

GetMintedBy returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.MintedBy, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetNote added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetNote() *string

GetNote returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.Note, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetOrganizationId added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) GetOrganizationId() string

GetOrganizationId returns ActionTicketsActionTicketsActionTicketsPageItemsActionTicket.OrganizationId, and is useful for accessing the field via an interface.

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) MarshalJSON added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) MarshalJSON() ([]byte, error)

func (*ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) UnmarshalJSON added in v0.6.0 

func (v *ActionTicketsActionTicketsActionTicketsPageItemsActionTicket) UnmarshalJSON(b []byte) error

type ActionTicketsResponse added in v0.6.0 

type ActionTicketsResponse struct {
	// The ticket ledger: minted, consumed-by-which-run, expired (org-ADMIN).
	ActionTickets *ActionTicketsActionTicketsActionTicketsPage `json:"actionTickets"`
}

ActionTicketsResponse is returned by ActionTickets on success.

func ActionTickets added in v0.6.0 

func ActionTickets(
	ctx_ context.Context,
	client_ graphql.Client,
	orgRef string,
	limit *int,
	offset *int,
) (data_ *ActionTicketsResponse, err_ error)

The ledger — minted / consumed-by-which-run / expired. Paged { items, total }.

func (*ActionTicketsResponse) GetActionTickets added in v0.6.0 

func (v *ActionTicketsResponse) GetActionTickets() *ActionTicketsActionTicketsActionTicketsPage

GetActionTickets returns ActionTicketsResponse.ActionTickets, and is useful for accessing the field via an interface.

type AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload added in v0.3.0 

type AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload struct {
	MemoryMember *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember `json:"memoryMember"`
}

AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload includes the requested fields of the GraphQL type AddMemoryMemberPayload.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload) GetMemoryMember added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload) GetMemoryMember() *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember

GetMemoryMember returns AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload.MemoryMember, and is useful for accessing the field via an interface.

type AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember added in v0.3.0 

type AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember struct {
	Role MemoryMemberRole                                                      `json:"role"`
	User *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser `json:"user"`
}

AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember includes the requested fields of the GraphQL type MemoryMember. The GraphQL type's documentation follows.

023-app-shape US4: symmetric team-membership row for group-class memory. The "Company Brain" model — multiple users collaboratively read/write a shared memory, governance by role, no single owner on the Memory itself.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember) GetRole added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember) GetRole() MemoryMemberRole

GetRole returns AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember.Role, and is useful for accessing the field via an interface.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember) GetUser added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember) GetUser() *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser

GetUser returns AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMember.User, and is useful for accessing the field via an interface.

type AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser added in v0.3.0 

type AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser struct {
	MemUserFields `json:"-"`
}

AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser includes the requested fields of the GraphQL type User.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetEmail added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetEmail() *string

GetEmail returns AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser.Email, and is useful for accessing the field via an interface.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetHandle added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetHandle() *string

GetHandle returns AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser.Handle, and is useful for accessing the field via an interface.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetId added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetId() string

GetId returns AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser.Id, and is useful for accessing the field via an interface.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetName added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) GetName() *string

GetName returns AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser.Name, and is useful for accessing the field via an interface.

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) MarshalJSON added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) MarshalJSON() ([]byte, error)

func (*AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) UnmarshalJSON added in v0.3.0 

func (v *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayloadMemoryMemberUser) UnmarshalJSON(b []byte) error

type AddMemoryMemberResponse added in v0.3.0 

type AddMemoryMemberResponse struct {
	// 023-app-shape US4 — add a team member to a group-class Memory.
	// Idempotent on the (memoryId, userId) PK: re-calling with a
	// different role upserts the role.
	//
	// The caller MUST be an owner of the Memory (role = owner). The
	// bootstrap case is handled by createMemory itself, which adds the
	// creator as the first owner of a newly-created group memory.
	//
	// Error codes (extensions.code, Error.name style):
	// - UNAUTHENTICATED — no logged-in user in context.
	// - FORBIDDEN — caller is not an owner of the memory. (Uniform
	// for missing-memory / wrong-class / not-an-owner cases, by
	// the same don't-leak-metadata rule as MemoryShare mutations.)
	// - InvalidMemoryClassForMemberError — memory is not group-class
	// (only reachable from non-GraphQL callers in v1 — the
	// caller-authority guard short-circuits to FORBIDDEN first).
	// - MemoryMemberUserMissingError — the userId doesn't resolve.
	// - LastOwnerProtectedError (FR-038) — reachable via the
	// idempotent upsert path when the call would demote an
	// existing sole owner to reader/writer.
	AddMemoryMember *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload `json:"addMemoryMember"`
}

AddMemoryMemberResponse is returned by AddMemoryMember on success.

func AddMemoryMember added in v0.3.0 

func AddMemoryMember(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	userRef string,
	role MemoryMemberRole,
) (data_ *AddMemoryMemberResponse, err_ error)

#764/#304: userRef + memoryRef are server-resolved (id / URN / handle / email), so the CLI passes the raw --user value straight through — no client-side user lookup. memoryRef receives the client-resolved memory id (a valid ref).

func (*AddMemoryMemberResponse) GetAddMemoryMember added in v0.3.0 

func (v *AddMemoryMemberResponse) GetAddMemoryMember() *AddMemoryMemberAddMemoryMemberAddMemoryMemberPayload

GetAddMemoryMember returns AddMemoryMemberResponse.AddMemoryMember, and is useful for accessing the field via an interface.

type AddOrgMemberAddOrgMember added in v0.3.0 

type AddOrgMemberAddOrgMember struct {
	Id string `json:"id"`
	// Target member's role in this org. Null when the viewer isn't an ADMIN/OWNER of the org (#384 field-level visibility); always visible for one's own membership.
	Role *Role                         `json:"role"`
	User *AddOrgMemberAddOrgMemberUser `json:"user"`
}

AddOrgMemberAddOrgMember includes the requested fields of the GraphQL type OrgMember. The GraphQL type's documentation follows.

Per-organization membership record for a user.

func (*AddOrgMemberAddOrgMember) GetId added in v0.3.0 

func (v *AddOrgMemberAddOrgMember) GetId() string

GetId returns AddOrgMemberAddOrgMember.Id, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMember) GetRole added in v0.3.0 

func (v *AddOrgMemberAddOrgMember) GetRole() *Role

GetRole returns AddOrgMemberAddOrgMember.Role, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMember) GetUser added in v0.3.0 

func (v *AddOrgMemberAddOrgMember) GetUser() *AddOrgMemberAddOrgMemberUser

GetUser returns AddOrgMemberAddOrgMember.User, and is useful for accessing the field via an interface.

type AddOrgMemberAddOrgMemberUser added in v0.3.0 

type AddOrgMemberAddOrgMemberUser struct {
	UserFields `json:"-"`
}

AddOrgMemberAddOrgMemberUser includes the requested fields of the GraphQL type User.

func (*AddOrgMemberAddOrgMemberUser) GetEmail added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) GetEmail() *string

GetEmail returns AddOrgMemberAddOrgMemberUser.Email, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetExternalAppId added in v0.9.0 

func (v *AddOrgMemberAddOrgMemberUser) GetExternalAppId() *string

GetExternalAppId returns AddOrgMemberAddOrgMemberUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetExternalId added in v0.9.0 

func (v *AddOrgMemberAddOrgMemberUser) GetExternalId() *string

GetExternalId returns AddOrgMemberAddOrgMemberUser.ExternalId, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetGithubId added in v0.9.0 

func (v *AddOrgMemberAddOrgMemberUser) GetGithubId() *int

GetGithubId returns AddOrgMemberAddOrgMemberUser.GithubId, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetGithubUsername added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) GetGithubUsername() *string

GetGithubUsername returns AddOrgMemberAddOrgMemberUser.GithubUsername, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetHandle added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) GetHandle() *string

GetHandle returns AddOrgMemberAddOrgMemberUser.Handle, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetId added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) GetId() string

GetId returns AddOrgMemberAddOrgMemberUser.Id, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetIdentityProvider added in v0.9.0 

func (v *AddOrgMemberAddOrgMemberUser) GetIdentityProvider() *string

GetIdentityProvider returns AddOrgMemberAddOrgMemberUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetLinkedAt added in v0.9.0 

func (v *AddOrgMemberAddOrgMemberUser) GetLinkedAt() *string

GetLinkedAt returns AddOrgMemberAddOrgMemberUser.LinkedAt, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetName added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) GetName() *string

GetName returns AddOrgMemberAddOrgMemberUser.Name, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetRoles added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) GetRoles() []Role

GetRoles returns AddOrgMemberAddOrgMemberUser.Roles, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) GetUrn added in v0.14.0 

func (v *AddOrgMemberAddOrgMemberUser) GetUrn() *string

GetUrn returns AddOrgMemberAddOrgMemberUser.Urn, and is useful for accessing the field via an interface.

func (*AddOrgMemberAddOrgMemberUser) MarshalJSON added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) MarshalJSON() ([]byte, error)

func (*AddOrgMemberAddOrgMemberUser) UnmarshalJSON added in v0.3.0 

func (v *AddOrgMemberAddOrgMemberUser) UnmarshalJSON(b []byte) error

type AddOrgMemberResponse added in v0.3.0 

type AddOrgMemberResponse struct {
	// Accepts the entity's ID or URN (orgId).
	AddOrgMember *AddOrgMemberAddOrgMember `json:"addOrgMember"`
}

AddOrgMemberResponse is returned by AddOrgMember on success.

func AddOrgMember added in v0.3.0 

func AddOrgMember(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId string,
	userId string,
	role Role,
) (data_ *AddOrgMemberResponse, err_ error)

func (*AddOrgMemberResponse) GetAddOrgMember added in v0.3.0 

func (v *AddOrgMemberResponse) GetAddOrgMember() *AddOrgMemberAddOrgMember

GetAddOrgMember returns AddOrgMemberResponse.AddOrgMember, and is useful for accessing the field via an interface.

type AdvanceChannelReadStateAdvanceChannelReadState added in v0.14.0 

type AdvanceChannelReadStateAdvanceChannelReadState struct {
	ChannelId   string  `json:"channelId"`
	AttendeeUrn *string `json:"attendeeUrn"`
	LastSeenSeq int     `json:"lastSeenSeq"`
	UpdatedAt   string  `json:"updatedAt"`
}

AdvanceChannelReadStateAdvanceChannelReadState includes the requested fields of the GraphQL type ChannelReadState. The GraphQL type's documentation follows.

Spec 049 Phase 7 — where an attendee is up to on a Channel (D-2026-09-13-009). Outside the register; keyed on the ATTENDEE (a Worker, or an Agent in an App); advances are monotonic. Mute is session state, never here.

func (*AdvanceChannelReadStateAdvanceChannelReadState) GetAttendeeUrn added in v0.14.0 

func (v *AdvanceChannelReadStateAdvanceChannelReadState) GetAttendeeUrn() *string

GetAttendeeUrn returns AdvanceChannelReadStateAdvanceChannelReadState.AttendeeUrn, and is useful for accessing the field via an interface.

func (*AdvanceChannelReadStateAdvanceChannelReadState) GetChannelId added in v0.14.0 

func (v *AdvanceChannelReadStateAdvanceChannelReadState) GetChannelId() string

GetChannelId returns AdvanceChannelReadStateAdvanceChannelReadState.ChannelId, and is useful for accessing the field via an interface.

func (*AdvanceChannelReadStateAdvanceChannelReadState) GetLastSeenSeq added in v0.14.0 

func (v *AdvanceChannelReadStateAdvanceChannelReadState) GetLastSeenSeq() int

GetLastSeenSeq returns AdvanceChannelReadStateAdvanceChannelReadState.LastSeenSeq, and is useful for accessing the field via an interface.

func (*AdvanceChannelReadStateAdvanceChannelReadState) GetUpdatedAt added in v0.14.0 

func (v *AdvanceChannelReadStateAdvanceChannelReadState) GetUpdatedAt() string

GetUpdatedAt returns AdvanceChannelReadStateAdvanceChannelReadState.UpdatedAt, and is useful for accessing the field via an interface.

type AdvanceChannelReadStateResponse added in v0.14.0 

type AdvanceChannelReadStateResponse struct {
	// Spec 049 Phase 7 — advance an attendee's cursor on a Channel (the relay's
	// write; §8.7 gate: the caller must be the attendee's DRIVER — a user whose
	// live session is bound to that Worker, or the App-key principal of the
	// attendee's App). Monotonic: a lower seq is a no-op that returns the cursor.
	// channelRef: the Channel's id or its address (`Channel.chatRootUrn`, #1171).
	AdvanceChannelReadState *AdvanceChannelReadStateAdvanceChannelReadState `json:"advanceChannelReadState"`
}

AdvanceChannelReadStateResponse is returned by AdvanceChannelReadState on success.

func AdvanceChannelReadState added in v0.14.0 

func AdvanceChannelReadState(
	ctx_ context.Context,
	client_ graphql.Client,
	channelRef string,
	attendeeRef string,
	seq int,
	appRef *string,
) (data_ *AdvanceChannelReadStateResponse, err_ error)

Advance an attendee's cursor. MONOTONIC: a lower seq is a no-op that returns the cursor unchanged, so this is safe to call with a stale watermark and the command must not present a no-op as a rewind.

func (*AdvanceChannelReadStateResponse) GetAdvanceChannelReadState added in v0.14.0 

func (v *AdvanceChannelReadStateResponse) GetAdvanceChannelReadState() *AdvanceChannelReadStateAdvanceChannelReadState

GetAdvanceChannelReadState returns AdvanceChannelReadStateResponse.AdvanceChannelReadState, and is useful for accessing the field via an interface.

type AgentFields added in v0.7.0 

type AgentFields struct {
	Id             string          `json:"id"`
	Urn            string          `json:"urn"`
	Name           string          `json:"name"`
	Description    *string         `json:"description"`
	Type           AgentType       `json:"type"`
	Visibility     AgentVisibility `json:"visibility"`
	OrganizationId *string         `json:"organizationId"`
	Surfaces       []string        `json:"surfaces"`
	SystemMemoryId *string         `json:"systemMemoryId"`
	// Templated Agent prompt. {{name}}/{{role}} bind to the Agent in chats or the named Worker in briefings.
	SystemPrompt *string `json:"systemPrompt"`
	AiProvider   *string `json:"aiProvider"`
	AiModel      *string `json:"aiModel"`
	HasAiApiKey  bool    `json:"hasAiApiKey"`
	// Persona role - free string with conventions ('backend-engineer').
	PersonaRole *string `json:"personaRole"`
	CreatedAt   string  `json:"createdAt"`
}

AgentFields includes the GraphQL fields of Agent requested by the fragment AgentFields. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*AgentFields) GetAiModel added in v0.7.0 

func (v *AgentFields) GetAiModel() *string

GetAiModel returns AgentFields.AiModel, and is useful for accessing the field via an interface.

func (*AgentFields) GetAiProvider added in v0.7.0 

func (v *AgentFields) GetAiProvider() *string

GetAiProvider returns AgentFields.AiProvider, and is useful for accessing the field via an interface.

func (*AgentFields) GetCreatedAt added in v0.7.0 

func (v *AgentFields) GetCreatedAt() string

GetCreatedAt returns AgentFields.CreatedAt, and is useful for accessing the field via an interface.

func (*AgentFields) GetDescription added in v0.7.0 

func (v *AgentFields) GetDescription() *string

GetDescription returns AgentFields.Description, and is useful for accessing the field via an interface.

func (*AgentFields) GetHasAiApiKey added in v0.7.0 

func (v *AgentFields) GetHasAiApiKey() bool

GetHasAiApiKey returns AgentFields.HasAiApiKey, and is useful for accessing the field via an interface.

func (*AgentFields) GetId added in v0.7.0 

func (v *AgentFields) GetId() string

GetId returns AgentFields.Id, and is useful for accessing the field via an interface.

func (*AgentFields) GetName added in v0.7.0 

func (v *AgentFields) GetName() string

GetName returns AgentFields.Name, and is useful for accessing the field via an interface.

func (*AgentFields) GetOrganizationId added in v0.7.0 

func (v *AgentFields) GetOrganizationId() *string

GetOrganizationId returns AgentFields.OrganizationId, and is useful for accessing the field via an interface.

func (*AgentFields) GetPersonaRole added in v0.9.0 

func (v *AgentFields) GetPersonaRole() *string

GetPersonaRole returns AgentFields.PersonaRole, and is useful for accessing the field via an interface.

func (*AgentFields) GetSurfaces added in v0.7.0 

func (v *AgentFields) GetSurfaces() []string

GetSurfaces returns AgentFields.Surfaces, and is useful for accessing the field via an interface.

func (*AgentFields) GetSystemMemoryId added in v0.7.0 

func (v *AgentFields) GetSystemMemoryId() *string

GetSystemMemoryId returns AgentFields.SystemMemoryId, and is useful for accessing the field via an interface.

func (*AgentFields) GetSystemPrompt added in v0.7.0 

func (v *AgentFields) GetSystemPrompt() *string

GetSystemPrompt returns AgentFields.SystemPrompt, and is useful for accessing the field via an interface.

func (*AgentFields) GetType added in v0.7.0 

func (v *AgentFields) GetType() AgentType

GetType returns AgentFields.Type, and is useful for accessing the field via an interface.

func (*AgentFields) GetUrn added in v0.7.0 

func (v *AgentFields) GetUrn() string

GetUrn returns AgentFields.Urn, and is useful for accessing the field via an interface.

func (*AgentFields) GetVisibility added in v0.7.0 

func (v *AgentFields) GetVisibility() AgentVisibility

GetVisibility returns AgentFields.Visibility, and is useful for accessing the field via an interface.

type AgentFilter added in v0.7.0 

type AgentFilter struct {
	// #782 — true restricts the list to the caller's OWN user-owned (org-less)
	// agents: organizationId IS NULL AND ownerUserId = the caller. For ALL
	// callers INCLUDING platform ADMIN/OWNER (owner scope is never an
	// admin-bypass surface), mirroring the owner-only personal/private memories
	// slice. Org-less by definition, so orgId is not consulted. App-key callers
	// (no user context) get an empty page. Powers the portal's "My agents".
	OwnedByMe  *bool            `json:"ownedByMe,omitempty"`
	Type       *AgentType       `json:"type,omitempty"`
	Visibility *AgentVisibility `json:"visibility,omitempty"`
}

Filter for the uniform agents() list (#473). Clauses AND-combine.

func (*AgentFilter) GetOwnedByMe added in v0.9.0 

func (v *AgentFilter) GetOwnedByMe() *bool

GetOwnedByMe returns AgentFilter.OwnedByMe, and is useful for accessing the field via an interface.

func (*AgentFilter) GetType added in v0.7.0 

func (v *AgentFilter) GetType() *AgentType

GetType returns AgentFilter.Type, and is useful for accessing the field via an interface.

func (*AgentFilter) GetVisibility added in v0.7.0 

func (v *AgentFilter) GetVisibility() *AgentVisibility

GetVisibility returns AgentFilter.Visibility, and is useful for accessing the field via an interface.

type AgentScheduleFields added in v0.6.0 

type AgentScheduleFields struct {
	Id             string  `json:"id"`
	OrganizationId string  `json:"organizationId"`
	AppId          string  `json:"appId"`
	AgentId        *string `json:"agentId"`
	Name           string  `json:"name"`
	// 5-field cron for recurring schedules; null for one-shots (#510).
	Cron         *string `json:"cron"`
	Timezone     string  `json:"timezone"`
	Enabled      bool    `json:"enabled"`
	EntryNodeUrn string  `json:"entryNodeUrn"`
	AiConfigName *string `json:"aiConfigName"`
	// On-behalf-of user captured at creation; v1 only the creator themself.
	UserId    *string          `json:"userId"`
	CreatedBy *string          `json:"createdBy"`
	EventData *json.RawMessage `json:"eventData"`
	Policy    *json.RawMessage `json:"policy"`
	LastRunAt *string          `json:"lastRunAt"`
	NextRunAt *string          `json:"nextRunAt"`
	CreatedAt string           `json:"createdAt"`
}

AgentScheduleFields includes the GraphQL fields of AgentSchedule requested by the fragment AgentScheduleFields. The GraphQL type's documentation follows.

Recurring trigger (cor:agt:010, D-2026-07-04-E).

func (*AgentScheduleFields) GetAgentId added in v0.6.0 

func (v *AgentScheduleFields) GetAgentId() *string

GetAgentId returns AgentScheduleFields.AgentId, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetAiConfigName added in v0.6.0 

func (v *AgentScheduleFields) GetAiConfigName() *string

GetAiConfigName returns AgentScheduleFields.AiConfigName, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetAppId added in v0.6.0 

func (v *AgentScheduleFields) GetAppId() string

GetAppId returns AgentScheduleFields.AppId, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetCreatedAt added in v0.6.0 

func (v *AgentScheduleFields) GetCreatedAt() string

GetCreatedAt returns AgentScheduleFields.CreatedAt, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetCreatedBy added in v0.6.0 

func (v *AgentScheduleFields) GetCreatedBy() *string

GetCreatedBy returns AgentScheduleFields.CreatedBy, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetCron added in v0.6.0 

func (v *AgentScheduleFields) GetCron() *string

GetCron returns AgentScheduleFields.Cron, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetEnabled added in v0.6.0 

func (v *AgentScheduleFields) GetEnabled() bool

GetEnabled returns AgentScheduleFields.Enabled, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetEntryNodeUrn added in v0.6.0 

func (v *AgentScheduleFields) GetEntryNodeUrn() string

GetEntryNodeUrn returns AgentScheduleFields.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetEventData added in v0.6.0 

func (v *AgentScheduleFields) GetEventData() *json.RawMessage

GetEventData returns AgentScheduleFields.EventData, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetId added in v0.6.0 

func (v *AgentScheduleFields) GetId() string

GetId returns AgentScheduleFields.Id, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetLastRunAt added in v0.6.0 

func (v *AgentScheduleFields) GetLastRunAt() *string

GetLastRunAt returns AgentScheduleFields.LastRunAt, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetName added in v0.6.0 

func (v *AgentScheduleFields) GetName() string

GetName returns AgentScheduleFields.Name, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetNextRunAt added in v0.6.0 

func (v *AgentScheduleFields) GetNextRunAt() *string

GetNextRunAt returns AgentScheduleFields.NextRunAt, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetOrganizationId added in v0.6.0 

func (v *AgentScheduleFields) GetOrganizationId() string

GetOrganizationId returns AgentScheduleFields.OrganizationId, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetPolicy added in v0.6.0 

func (v *AgentScheduleFields) GetPolicy() *json.RawMessage

GetPolicy returns AgentScheduleFields.Policy, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetTimezone added in v0.6.0 

func (v *AgentScheduleFields) GetTimezone() string

GetTimezone returns AgentScheduleFields.Timezone, and is useful for accessing the field via an interface.

func (*AgentScheduleFields) GetUserId added in v0.6.0 

func (v *AgentScheduleFields) GetUserId() *string

GetUserId returns AgentScheduleFields.UserId, and is useful for accessing the field via an interface.

type AgentSchedulesAgentSchedulesAgentSchedulesPage added in v0.6.0 

type AgentSchedulesAgentSchedulesAgentSchedulesPage struct {
	Total int                                                                 `json:"total"`
	Items []*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule `json:"items"`
}

AgentSchedulesAgentSchedulesAgentSchedulesPage includes the requested fields of the GraphQL type AgentSchedulesPage.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPage) GetItems added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPage) GetItems() []*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule

GetItems returns AgentSchedulesAgentSchedulesAgentSchedulesPage.Items, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPage) GetTotal added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPage) GetTotal() int

GetTotal returns AgentSchedulesAgentSchedulesAgentSchedulesPage.Total, and is useful for accessing the field via an interface.

type AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule added in v0.6.0 

type AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule struct {
	AgentScheduleFields `json:"-"`
}

AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule includes the requested fields of the GraphQL type AgentSchedule. The GraphQL type's documentation follows.

Recurring trigger (cor:agt:010, D-2026-07-04-E).

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetAgentId added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetAgentId() *string

GetAgentId returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.AgentId, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetAiConfigName added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetAiConfigName() *string

GetAiConfigName returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.AiConfigName, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetAppId added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetAppId() string

GetAppId returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.AppId, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetCreatedAt added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetCreatedAt() string

GetCreatedAt returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.CreatedAt, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetCreatedBy added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetCreatedBy() *string

GetCreatedBy returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.CreatedBy, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetCron added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetCron() *string

GetCron returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.Cron, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetEnabled added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetEnabled() bool

GetEnabled returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.Enabled, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetEntryNodeUrn added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetEntryNodeUrn() string

GetEntryNodeUrn returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetEventData added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetEventData() *json.RawMessage

GetEventData returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.EventData, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetId added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetId() string

GetId returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.Id, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetLastRunAt added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetLastRunAt() *string

GetLastRunAt returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.LastRunAt, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetName added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetName() string

GetName returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.Name, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetNextRunAt added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetNextRunAt() *string

GetNextRunAt returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.NextRunAt, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetOrganizationId added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetOrganizationId() string

GetOrganizationId returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.OrganizationId, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetPolicy added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetPolicy() *json.RawMessage

GetPolicy returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.Policy, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetTimezone added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetTimezone() string

GetTimezone returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.Timezone, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetUserId added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) GetUserId() *string

GetUserId returns AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule.UserId, and is useful for accessing the field via an interface.

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) MarshalJSON added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) MarshalJSON() ([]byte, error)

func (*AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) UnmarshalJSON added in v0.6.0 

func (v *AgentSchedulesAgentSchedulesAgentSchedulesPageItemsAgentSchedule) UnmarshalJSON(b []byte) error

type AgentSchedulesResponse added in v0.6.0 

type AgentSchedulesResponse struct {
	AgentSchedules *AgentSchedulesAgentSchedulesAgentSchedulesPage `json:"agentSchedules"`
}

AgentSchedulesResponse is returned by AgentSchedules on success.

func AgentSchedules added in v0.6.0 

func AgentSchedules(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	limit *int,
	offset *int,
) (data_ *AgentSchedulesResponse, err_ error)

func (*AgentSchedulesResponse) GetAgentSchedules added in v0.6.0 

func (v *AgentSchedulesResponse) GetAgentSchedules() *AgentSchedulesAgentSchedulesAgentSchedulesPage

GetAgentSchedules returns AgentSchedulesResponse.AgentSchedules, and is useful for accessing the field via an interface.

type AgentType added in v0.7.0 

type AgentType string
const (
	AgentTypeAssistant AgentType = "ASSISTANT"
	AgentTypeChatbot   AgentType = "CHATBOT"
)

type AgentVisibility added in v0.7.0 

type AgentVisibility string

035-visibility-enum-cleanup: agents have their own visibility enum, decoupled from MemoryVisibility. PERSONAL is the creator-only draft state. 

const (
	AgentVisibilityOrganization AgentVisibility = "ORGANIZATION"
	AgentVisibilityPersonal     AgentVisibility = "PERSONAL"
	AgentVisibilityPublic       AgentVisibility = "PUBLIC"
)

type AgentWebhookCredentialFields added in v0.6.0 

type AgentWebhookCredentialFields struct {
	// Server-relative URL path: /hooks/<secret>/<name>. Append ?hpt=<token>.
	Path string `json:"path"`
	// The time-limited platform JWT (hpt) — the second factor. Store it now.
	Token   string                                           `json:"token"`
	Webhook *AgentWebhookCredentialFieldsWebhookAgentWebhook `json:"webhook"`
}

AgentWebhookCredentialFields includes the GraphQL fields of AgentWebhookCredentials requested by the fragment AgentWebhookCredentialFields. The GraphQL type's documentation follows.

Create/rotate result — path + platform token are shown ONCE.

func (*AgentWebhookCredentialFields) GetPath added in v0.6.0 

func (v *AgentWebhookCredentialFields) GetPath() string

GetPath returns AgentWebhookCredentialFields.Path, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFields) GetToken added in v0.6.0 

func (v *AgentWebhookCredentialFields) GetToken() string

GetToken returns AgentWebhookCredentialFields.Token, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFields) GetWebhook added in v0.6.0 

func (v *AgentWebhookCredentialFields) GetWebhook() *AgentWebhookCredentialFieldsWebhookAgentWebhook

GetWebhook returns AgentWebhookCredentialFields.Webhook, and is useful for accessing the field via an interface.

type AgentWebhookCredentialFieldsWebhookAgentWebhook added in v0.6.0 

type AgentWebhookCredentialFieldsWebhookAgentWebhook struct {
	AgentWebhookFields `json:"-"`
}

AgentWebhookCredentialFieldsWebhookAgentWebhook includes the requested fields of the GraphQL type AgentWebhook. The GraphQL type's documentation follows.

Webhook trigger (D-2026-05-02). The secret is NEVER exposed here — the URL is returned once at create/rotate.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetAgentId added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetAgentId() *string

GetAgentId returns AgentWebhookCredentialFieldsWebhookAgentWebhook.AgentId, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetAiConfigName added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetAiConfigName() *string

GetAiConfigName returns AgentWebhookCredentialFieldsWebhookAgentWebhook.AiConfigName, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetAppId added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetAppId() string

GetAppId returns AgentWebhookCredentialFieldsWebhookAgentWebhook.AppId, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetArgsSchema added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetArgsSchema() *json.RawMessage

GetArgsSchema returns AgentWebhookCredentialFieldsWebhookAgentWebhook.ArgsSchema, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetCreatedAt added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetCreatedAt() string

GetCreatedAt returns AgentWebhookCredentialFieldsWebhookAgentWebhook.CreatedAt, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetCreatedBy added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetCreatedBy() *string

GetCreatedBy returns AgentWebhookCredentialFieldsWebhookAgentWebhook.CreatedBy, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetEnabled added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetEnabled() bool

GetEnabled returns AgentWebhookCredentialFieldsWebhookAgentWebhook.Enabled, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetEntryNodeUrn added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetEntryNodeUrn() string

GetEntryNodeUrn returns AgentWebhookCredentialFieldsWebhookAgentWebhook.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetEventData added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetEventData() *json.RawMessage

GetEventData returns AgentWebhookCredentialFieldsWebhookAgentWebhook.EventData, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetId added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetId() string

GetId returns AgentWebhookCredentialFieldsWebhookAgentWebhook.Id, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetLastCalledAt added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetLastCalledAt() *string

GetLastCalledAt returns AgentWebhookCredentialFieldsWebhookAgentWebhook.LastCalledAt, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetName added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetName() string

GetName returns AgentWebhookCredentialFieldsWebhookAgentWebhook.Name, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetOrganizationId added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetOrganizationId() string

GetOrganizationId returns AgentWebhookCredentialFieldsWebhookAgentWebhook.OrganizationId, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetPolicy added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetPolicy() *json.RawMessage

GetPolicy returns AgentWebhookCredentialFieldsWebhookAgentWebhook.Policy, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) GetUserId added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) GetUserId() *string

GetUserId returns AgentWebhookCredentialFieldsWebhookAgentWebhook.UserId, and is useful for accessing the field via an interface.

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) MarshalJSON added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) MarshalJSON() ([]byte, error)

func (*AgentWebhookCredentialFieldsWebhookAgentWebhook) UnmarshalJSON added in v0.6.0 

func (v *AgentWebhookCredentialFieldsWebhookAgentWebhook) UnmarshalJSON(b []byte) error

type AgentWebhookFields added in v0.6.0 

type AgentWebhookFields struct {
	Id             string           `json:"id"`
	OrganizationId string           `json:"organizationId"`
	AppId          string           `json:"appId"`
	AgentId        *string          `json:"agentId"`
	Name           string           `json:"name"`
	Enabled        bool             `json:"enabled"`
	EntryNodeUrn   string           `json:"entryNodeUrn"`
	AiConfigName   *string          `json:"aiConfigName"`
	UserId         *string          `json:"userId"`
	CreatedBy      *string          `json:"createdBy"`
	ArgsSchema     *json.RawMessage `json:"argsSchema"`
	EventData      *json.RawMessage `json:"eventData"`
	Policy         *json.RawMessage `json:"policy"`
	LastCalledAt   *string          `json:"lastCalledAt"`
	CreatedAt      string           `json:"createdAt"`
}

AgentWebhookFields includes the GraphQL fields of AgentWebhook requested by the fragment AgentWebhookFields. The GraphQL type's documentation follows.

Webhook trigger (D-2026-05-02). The secret is NEVER exposed here — the URL is returned once at create/rotate.

func (*AgentWebhookFields) GetAgentId added in v0.6.0 

func (v *AgentWebhookFields) GetAgentId() *string

GetAgentId returns AgentWebhookFields.AgentId, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetAiConfigName added in v0.6.0 

func (v *AgentWebhookFields) GetAiConfigName() *string

GetAiConfigName returns AgentWebhookFields.AiConfigName, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetAppId added in v0.6.0 

func (v *AgentWebhookFields) GetAppId() string

GetAppId returns AgentWebhookFields.AppId, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetArgsSchema added in v0.6.0 

func (v *AgentWebhookFields) GetArgsSchema() *json.RawMessage

GetArgsSchema returns AgentWebhookFields.ArgsSchema, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetCreatedAt added in v0.6.0 

func (v *AgentWebhookFields) GetCreatedAt() string

GetCreatedAt returns AgentWebhookFields.CreatedAt, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetCreatedBy added in v0.6.0 

func (v *AgentWebhookFields) GetCreatedBy() *string

GetCreatedBy returns AgentWebhookFields.CreatedBy, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetEnabled added in v0.6.0 

func (v *AgentWebhookFields) GetEnabled() bool

GetEnabled returns AgentWebhookFields.Enabled, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetEntryNodeUrn added in v0.6.0 

func (v *AgentWebhookFields) GetEntryNodeUrn() string

GetEntryNodeUrn returns AgentWebhookFields.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetEventData added in v0.6.0 

func (v *AgentWebhookFields) GetEventData() *json.RawMessage

GetEventData returns AgentWebhookFields.EventData, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetId added in v0.6.0 

func (v *AgentWebhookFields) GetId() string

GetId returns AgentWebhookFields.Id, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetLastCalledAt added in v0.6.0 

func (v *AgentWebhookFields) GetLastCalledAt() *string

GetLastCalledAt returns AgentWebhookFields.LastCalledAt, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetName added in v0.6.0 

func (v *AgentWebhookFields) GetName() string

GetName returns AgentWebhookFields.Name, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetOrganizationId added in v0.6.0 

func (v *AgentWebhookFields) GetOrganizationId() string

GetOrganizationId returns AgentWebhookFields.OrganizationId, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetPolicy added in v0.6.0 

func (v *AgentWebhookFields) GetPolicy() *json.RawMessage

GetPolicy returns AgentWebhookFields.Policy, and is useful for accessing the field via an interface.

func (*AgentWebhookFields) GetUserId added in v0.6.0 

func (v *AgentWebhookFields) GetUserId() *string

GetUserId returns AgentWebhookFields.UserId, and is useful for accessing the field via an interface.

type AgentWebhooksAgentWebhooksAgentWebhooksPage added in v0.6.0 

type AgentWebhooksAgentWebhooksAgentWebhooksPage struct {
	Total int                                                             `json:"total"`
	Items []*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook `json:"items"`
}

AgentWebhooksAgentWebhooksAgentWebhooksPage includes the requested fields of the GraphQL type AgentWebhooksPage.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPage) GetItems added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPage) GetItems() []*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook

GetItems returns AgentWebhooksAgentWebhooksAgentWebhooksPage.Items, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPage) GetTotal added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPage) GetTotal() int

GetTotal returns AgentWebhooksAgentWebhooksAgentWebhooksPage.Total, and is useful for accessing the field via an interface.

type AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook added in v0.6.0 

type AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook struct {
	AgentWebhookFields `json:"-"`
}

AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook includes the requested fields of the GraphQL type AgentWebhook. The GraphQL type's documentation follows.

Webhook trigger (D-2026-05-02). The secret is NEVER exposed here — the URL is returned once at create/rotate.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetAgentId added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetAgentId() *string

GetAgentId returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.AgentId, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetAiConfigName added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetAiConfigName() *string

GetAiConfigName returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.AiConfigName, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetAppId added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetAppId() string

GetAppId returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.AppId, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetArgsSchema added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetArgsSchema() *json.RawMessage

GetArgsSchema returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.ArgsSchema, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetCreatedAt added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetCreatedAt() string

GetCreatedAt returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.CreatedAt, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetCreatedBy added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetCreatedBy() *string

GetCreatedBy returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.CreatedBy, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetEnabled added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetEnabled() bool

GetEnabled returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.Enabled, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetEntryNodeUrn added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetEntryNodeUrn() string

GetEntryNodeUrn returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetEventData added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetEventData() *json.RawMessage

GetEventData returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.EventData, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetId added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetId() string

GetId returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.Id, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetLastCalledAt added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetLastCalledAt() *string

GetLastCalledAt returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.LastCalledAt, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetName added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetName() string

GetName returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.Name, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetOrganizationId added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetOrganizationId() string

GetOrganizationId returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.OrganizationId, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetPolicy added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetPolicy() *json.RawMessage

GetPolicy returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.Policy, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetUserId added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) GetUserId() *string

GetUserId returns AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook.UserId, and is useful for accessing the field via an interface.

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) MarshalJSON added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) MarshalJSON() ([]byte, error)

func (*AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) UnmarshalJSON added in v0.6.0 

func (v *AgentWebhooksAgentWebhooksAgentWebhooksPageItemsAgentWebhook) UnmarshalJSON(b []byte) error

type AgentWebhooksResponse added in v0.6.0 

type AgentWebhooksResponse struct {
	AgentWebhooks *AgentWebhooksAgentWebhooksAgentWebhooksPage `json:"agentWebhooks"`
}

AgentWebhooksResponse is returned by AgentWebhooks on success.

func AgentWebhooks added in v0.6.0 

func AgentWebhooks(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	limit *int,
	offset *int,
) (data_ *AgentWebhooksResponse, err_ error)

func (*AgentWebhooksResponse) GetAgentWebhooks added in v0.6.0 

func (v *AgentWebhooksResponse) GetAgentWebhooks() *AgentWebhooksAgentWebhooksAgentWebhooksPage

GetAgentWebhooks returns AgentWebhooksResponse.AgentWebhooks, and is useful for accessing the field via an interface.

type AgentsAgentsAgentsPage added in v0.7.0 

type AgentsAgentsAgentsPage struct {
	Total int                                 `json:"total"`
	Items []*AgentsAgentsAgentsPageItemsAgent `json:"items"`
}

AgentsAgentsAgentsPage includes the requested fields of the GraphQL type AgentsPage.

func (*AgentsAgentsAgentsPage) GetItems added in v0.7.0 

func (v *AgentsAgentsAgentsPage) GetItems() []*AgentsAgentsAgentsPageItemsAgent

GetItems returns AgentsAgentsAgentsPage.Items, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPage) GetTotal added in v0.7.0 

func (v *AgentsAgentsAgentsPage) GetTotal() int

GetTotal returns AgentsAgentsAgentsPage.Total, and is useful for accessing the field via an interface.

type AgentsAgentsAgentsPageItemsAgent added in v0.7.0 

type AgentsAgentsAgentsPageItemsAgent struct {
	AgentFields `json:"-"`
}

AgentsAgentsAgentsPageItemsAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*AgentsAgentsAgentsPageItemsAgent) GetAiModel added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetAiModel() *string

GetAiModel returns AgentsAgentsAgentsPageItemsAgent.AiModel, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetAiProvider added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetAiProvider() *string

GetAiProvider returns AgentsAgentsAgentsPageItemsAgent.AiProvider, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetCreatedAt added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetCreatedAt() string

GetCreatedAt returns AgentsAgentsAgentsPageItemsAgent.CreatedAt, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetDescription added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetDescription() *string

GetDescription returns AgentsAgentsAgentsPageItemsAgent.Description, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetHasAiApiKey added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetHasAiApiKey() bool

GetHasAiApiKey returns AgentsAgentsAgentsPageItemsAgent.HasAiApiKey, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetId added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetId() string

GetId returns AgentsAgentsAgentsPageItemsAgent.Id, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetName added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetName() string

GetName returns AgentsAgentsAgentsPageItemsAgent.Name, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetOrganizationId added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetOrganizationId() *string

GetOrganizationId returns AgentsAgentsAgentsPageItemsAgent.OrganizationId, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetPersonaRole added in v0.9.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetPersonaRole() *string

GetPersonaRole returns AgentsAgentsAgentsPageItemsAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetSurfaces added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetSurfaces() []string

GetSurfaces returns AgentsAgentsAgentsPageItemsAgent.Surfaces, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetSystemMemoryId added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetSystemMemoryId() *string

GetSystemMemoryId returns AgentsAgentsAgentsPageItemsAgent.SystemMemoryId, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetSystemPrompt added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetSystemPrompt() *string

GetSystemPrompt returns AgentsAgentsAgentsPageItemsAgent.SystemPrompt, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetType added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetType() AgentType

GetType returns AgentsAgentsAgentsPageItemsAgent.Type, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetUrn added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetUrn() string

GetUrn returns AgentsAgentsAgentsPageItemsAgent.Urn, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) GetVisibility added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetVisibility() AgentVisibility

GetVisibility returns AgentsAgentsAgentsPageItemsAgent.Visibility, and is useful for accessing the field via an interface.

func (*AgentsAgentsAgentsPageItemsAgent) MarshalJSON added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) MarshalJSON() ([]byte, error)

func (*AgentsAgentsAgentsPageItemsAgent) UnmarshalJSON added in v0.7.0 

func (v *AgentsAgentsAgentsPageItemsAgent) UnmarshalJSON(b []byte) error

type AgentsResponse added in v0.7.0 

type AgentsResponse struct {
	// Uniform paginated agent list (#473). Scope: Agents owned by the caller's
	// member orgs; platform ADMIN/OWNER unscoped get every live Agent. orgId
	// follows cor:api:100:01 (member -> scope, non-member -> empty page, no
	// disclosure, no admin bypass). filter narrows by type / visibility.
	// filter.ownedByMe (#782) narrows to the caller's own user-owned (org-less)
	// agents for every caller including platform admins. Name-ascending order
	// (id tiebreak); limit default 50 / cap 200; limit: 0 -> count only.
	Agents *AgentsAgentsAgentsPage `json:"agents"`
}

AgentsResponse is returned by Agents on success.

func Agents added in v0.7.0 

func Agents(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId *string,
	filter *AgentFilter,
	limit *int,
	offset *int,
) (data_ *AgentsResponse, err_ error)

func (*AgentsResponse) GetAgents added in v0.7.0 

func (v *AgentsResponse) GetAgents() *AgentsAgentsAgentsPage

GetAgents returns AgentsResponse.Agents, and is useful for accessing the field via an interface.

type AiConfigOwnerType added in v0.2.0 

type AiConfigOwnerType string

036-ai-service-config: which entity owns an AiServiceConfig. Exactly one owner per config (DB-enforced). 

const (
	AiConfigOwnerTypeAgent        AiConfigOwnerType = "AGENT"
	AiConfigOwnerTypeApp          AiConfigOwnerType = "APP"
	AiConfigOwnerTypeHadronServer AiConfigOwnerType = "HADRON_SERVER"
	AiConfigOwnerTypeOrganization AiConfigOwnerType = "ORGANIZATION"
)

type AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint added in v0.18.0 

type AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint struct {
	Url   string `json:"url"`
	Label string `json:"label"`
	// The endpoint a config with no endpoint uses.
	IsDefault bool `json:"isDefault"`
	// What the URL does not say: billing, terms.
	Note *string `json:"note"`
}

AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint includes the requested fields of the GraphQL type AiProviderEndpoint. The GraphQL type's documentation follows.

#1373: one known endpoint for a provider, from the server's single suggestion list.

func (*AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetIsDefault added in v0.18.0 

func (v *AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetIsDefault() bool

GetIsDefault returns AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint.IsDefault, and is useful for accessing the field via an interface.

func (*AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetLabel added in v0.18.0 

func (v *AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetLabel() string

GetLabel returns AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint.Label, and is useful for accessing the field via an interface.

func (*AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetNote added in v0.18.0 

func (v *AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetNote() *string

GetNote returns AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint.Note, and is useful for accessing the field via an interface.

func (*AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetUrl added in v0.18.0 

func (v *AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint) GetUrl() string

GetUrl returns AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint.Url, and is useful for accessing the field via an interface.

type AiProviderEndpointsResponse added in v0.18.0 

type AiProviderEndpointsResponse struct {
	// #1373: the known endpoints for a provider — the server's single suggestion
	// list, so the portal and the CLI render the same choices and neither
	// hardcodes a URL. Empty for an unknown provider and for bedrock (its
	// endpoint comes from the region). Public reference data (vendor URLs), so
	// it needs no auth.
	AiProviderEndpoints []*AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint `json:"aiProviderEndpoints"`
}

AiProviderEndpointsResponse is returned by AiProviderEndpoints on success.

func AiProviderEndpoints added in v0.18.0 

func AiProviderEndpoints(
	ctx_ context.Context,
	client_ graphql.Client,
	provider string,
) (data_ *AiProviderEndpointsResponse, err_ error)

func (*AiProviderEndpointsResponse) GetAiProviderEndpoints added in v0.18.0 

func (v *AiProviderEndpointsResponse) GetAiProviderEndpoints() []*AiProviderEndpointsAiProviderEndpointsAiProviderEndpoint

GetAiProviderEndpoints returns AiProviderEndpointsResponse.AiProviderEndpoints, and is useful for accessing the field via an interface.

type AiServiceConfigEndpointFields added in v0.18.0 

type AiServiceConfigEndpointFields 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; known: 'anthropic' | 'openai' | 'glm' | 'bedrock' | 'openai-compatible' (any OpenAI-wire host; endpoint required).
	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"`
	// #1373: the base URL this config's requests are sent to, as stored. Null =
	// the provider's default (see effectiveEndpoint and aiProviderEndpoints).
	Endpoint *string `json:"endpoint"`
	// #1373: where a request for this config actually goes: endpoint, else the
	// provider default. Null only for bedrock, whose endpoint is derived from
	// its region.
	EffectiveEndpoint *string `json:"effectiveEndpoint"`
	// Disabled configs are skipped by resolution (the walk continues outward).
	Enabled   bool    `json:"enabled"`
	CreatedAt string  `json:"createdAt"`
	UpdatedAt *string `json:"updatedAt"`
}

Endpoint-aware operations are separate from the original AI-config CRUD and picker operations. An older server can still serve the original commands; asking for endpoint fields or arguments explicitly requires the new contract.

func (*AiServiceConfigEndpointFields) GetApiKeyPreview added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetApiKeyPreview() *string

GetApiKeyPreview returns AiServiceConfigEndpointFields.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetCreatedAt added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetCreatedAt() string

GetCreatedAt returns AiServiceConfigEndpointFields.CreatedAt, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetEffectiveEndpoint added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetEffectiveEndpoint() *string

GetEffectiveEndpoint returns AiServiceConfigEndpointFields.EffectiveEndpoint, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetEnabled added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetEnabled() bool

GetEnabled returns AiServiceConfigEndpointFields.Enabled, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetEndpoint added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetEndpoint() *string

GetEndpoint returns AiServiceConfigEndpointFields.Endpoint, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetHasApiKey added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetHasApiKey() bool

GetHasApiKey returns AiServiceConfigEndpointFields.HasApiKey, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetId added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetId() string

GetId returns AiServiceConfigEndpointFields.Id, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetModel added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetModel() string

GetModel returns AiServiceConfigEndpointFields.Model, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetName added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetName() string

GetName returns AiServiceConfigEndpointFields.Name, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetOwnerId added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetOwnerId() string

GetOwnerId returns AiServiceConfigEndpointFields.OwnerId, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetOwnerType added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetOwnerType() AiConfigOwnerType

GetOwnerType returns AiServiceConfigEndpointFields.OwnerType, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetParams added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetParams() *json.RawMessage

GetParams returns AiServiceConfigEndpointFields.Params, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetProvider added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetProvider() string

GetProvider returns AiServiceConfigEndpointFields.Provider, and is useful for accessing the field via an interface.

func (*AiServiceConfigEndpointFields) GetUpdatedAt added in v0.18.0 

func (v *AiServiceConfigEndpointFields) GetUpdatedAt() *string

GetUpdatedAt returns AiServiceConfigEndpointFields.UpdatedAt, and is useful for accessing the field via an interface.

type AiServiceConfigFields added in v0.3.0 

type AiServiceConfigFields 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; known: 'anthropic' | 'openai' | 'glm' | 'bedrock' | 'openai-compatible' (any OpenAI-wire host; endpoint required).
	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"`
}

036-ai-service-config CRUD. The mutations return a masked AiServiceConfig (never key material — only hasApiKey + apiKeyPreview).

func (*AiServiceConfigFields) GetApiKeyPreview added in v0.3.0 

func (v *AiServiceConfigFields) GetApiKeyPreview() *string

GetApiKeyPreview returns AiServiceConfigFields.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetCreatedAt added in v0.3.0 

func (v *AiServiceConfigFields) GetCreatedAt() string

GetCreatedAt returns AiServiceConfigFields.CreatedAt, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetEnabled added in v0.3.0 

func (v *AiServiceConfigFields) GetEnabled() bool

GetEnabled returns AiServiceConfigFields.Enabled, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetHasApiKey added in v0.3.0 

func (v *AiServiceConfigFields) GetHasApiKey() bool

GetHasApiKey returns AiServiceConfigFields.HasApiKey, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetId added in v0.3.0 

func (v *AiServiceConfigFields) GetId() string

GetId returns AiServiceConfigFields.Id, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetModel added in v0.3.0 

func (v *AiServiceConfigFields) GetModel() string

GetModel returns AiServiceConfigFields.Model, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetName added in v0.3.0 

func (v *AiServiceConfigFields) GetName() string

GetName returns AiServiceConfigFields.Name, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetOwnerId added in v0.3.0 

func (v *AiServiceConfigFields) GetOwnerId() string

GetOwnerId returns AiServiceConfigFields.OwnerId, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetOwnerType added in v0.3.0 

func (v *AiServiceConfigFields) GetOwnerType() AiConfigOwnerType

GetOwnerType returns AiServiceConfigFields.OwnerType, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetParams added in v0.3.0 

func (v *AiServiceConfigFields) GetParams() *json.RawMessage

GetParams returns AiServiceConfigFields.Params, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetProvider added in v0.3.0 

func (v *AiServiceConfigFields) GetProvider() string

GetProvider returns AiServiceConfigFields.Provider, and is useful for accessing the field via an interface.

func (*AiServiceConfigFields) GetUpdatedAt added in v0.3.0 

func (v *AiServiceConfigFields) GetUpdatedAt() *string

GetUpdatedAt returns AiServiceConfigFields.UpdatedAt, and is useful for accessing the field via an interface.

type AiServiceConfigWithEndpointAiServiceConfig added in v0.18.0 

type AiServiceConfigWithEndpointAiServiceConfig struct {
	AiServiceConfigEndpointFields `json:"-"`
}

AiServiceConfigWithEndpointAiServiceConfig includes the requested fields of the GraphQL type AiServiceConfig. The GraphQL type's documentation follows.

036-ai-service-config: a named AI service configuration (masked management view — never carries key material beyond the preview). Owned by exactly one of HadronServer / Organization / App / Agent. Resolution walks App -> Agent -> Org (of the App) -> HadronServer and returns the first ENABLED config with the requested name. Well-known fallback name: 'default' (conventional extras: 'fast', 'frontier'). Name is unique per owner.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetApiKeyPreview added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetApiKeyPreview() *string

GetApiKeyPreview returns AiServiceConfigWithEndpointAiServiceConfig.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetCreatedAt added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetCreatedAt() string

GetCreatedAt returns AiServiceConfigWithEndpointAiServiceConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetEffectiveEndpoint added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetEffectiveEndpoint() *string

GetEffectiveEndpoint returns AiServiceConfigWithEndpointAiServiceConfig.EffectiveEndpoint, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetEnabled added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetEnabled() bool

GetEnabled returns AiServiceConfigWithEndpointAiServiceConfig.Enabled, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetEndpoint added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetEndpoint() *string

GetEndpoint returns AiServiceConfigWithEndpointAiServiceConfig.Endpoint, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetHasApiKey added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetHasApiKey() bool

GetHasApiKey returns AiServiceConfigWithEndpointAiServiceConfig.HasApiKey, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetId added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetId() string

GetId returns AiServiceConfigWithEndpointAiServiceConfig.Id, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetModel added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetModel() string

GetModel returns AiServiceConfigWithEndpointAiServiceConfig.Model, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetName added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetName() string

GetName returns AiServiceConfigWithEndpointAiServiceConfig.Name, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetOwnerId added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetOwnerId() string

GetOwnerId returns AiServiceConfigWithEndpointAiServiceConfig.OwnerId, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetOwnerType added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetOwnerType() AiConfigOwnerType

GetOwnerType returns AiServiceConfigWithEndpointAiServiceConfig.OwnerType, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetParams added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetParams() *json.RawMessage

GetParams returns AiServiceConfigWithEndpointAiServiceConfig.Params, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetProvider added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetProvider() string

GetProvider returns AiServiceConfigWithEndpointAiServiceConfig.Provider, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) GetUpdatedAt added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) GetUpdatedAt() *string

GetUpdatedAt returns AiServiceConfigWithEndpointAiServiceConfig.UpdatedAt, and is useful for accessing the field via an interface.

func (*AiServiceConfigWithEndpointAiServiceConfig) MarshalJSON added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) MarshalJSON() ([]byte, error)

func (*AiServiceConfigWithEndpointAiServiceConfig) UnmarshalJSON added in v0.18.0 

func (v *AiServiceConfigWithEndpointAiServiceConfig) UnmarshalJSON(b []byte) error

type AiServiceConfigWithEndpointResponse added in v0.18.0 

type AiServiceConfigWithEndpointResponse struct {
	// The uniform single-config read (#473). 'ref' is the config's ID —
	// AiServiceConfig is the one URN-less entity (matching resolveUrn /
	// effectiveAccess dispatch). Masked: never returns key material, only
	// hasApiKey + apiKeyPreview (resolveAIConfig is the privileged decrypted
	// read). Auth mirrors the list: platform ADMIN/OWNER for
	// HADRON_SERVER-owned configs, org ADMIN of the owning org otherwise;
	// denied throws Forbidden, missing is null.
	AiServiceConfig *AiServiceConfigWithEndpointAiServiceConfig `json:"aiServiceConfig"`
}

AiServiceConfigWithEndpointResponse is returned by AiServiceConfigWithEndpoint on success.

func AiServiceConfigWithEndpoint added in v0.18.0 

func AiServiceConfigWithEndpoint(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *AiServiceConfigWithEndpointResponse, err_ error)

func (*AiServiceConfigWithEndpointResponse) GetAiServiceConfig added in v0.18.0 

func (v *AiServiceConfigWithEndpointResponse) GetAiServiceConfig() *AiServiceConfigWithEndpointAiServiceConfig

GetAiServiceConfig returns AiServiceConfigWithEndpointResponse.AiServiceConfig, and is useful for accessing the field via an interface.

type AppAgentRosterApp added in v0.9.0 

type AppAgentRosterApp struct {
	Id   string `json:"id"`
	Urn  string `json:"urn"`
	Name string `json:"name"`
	// 023-app-shape: convenience that returns every installed Agent
	// (equivalent to App.appAgents.map(aa => aa.agent)). Previously was
	// a soft-deprecated single-element synthesis; now returns the FULL
	// multi-Agent set per spec 023 US1.
	Agents []*AppAgentRosterAppAgentsAgent `json:"agents"`
}

AppAgentRosterApp includes the requested fields of the GraphQL type App. The GraphQL type's documentation follows.

A runtime caller identity owned by exactly one Organization or User. It owns long-lived App Keys and installs Agents through the AppAgent N:M join: one App may install many Agents, and one Agent may be installed in many Apps. The singular agentId / agent fields below are soft-deprecated convenience reads of the first install, not a direct foreign key.

func (*AppAgentRosterApp) GetAgents added in v0.9.0 

func (v *AppAgentRosterApp) GetAgents() []*AppAgentRosterAppAgentsAgent

GetAgents returns AppAgentRosterApp.Agents, and is useful for accessing the field via an interface.

func (*AppAgentRosterApp) GetId added in v0.9.0 

func (v *AppAgentRosterApp) GetId() string

GetId returns AppAgentRosterApp.Id, and is useful for accessing the field via an interface.

func (*AppAgentRosterApp) GetName added in v0.9.0 

func (v *AppAgentRosterApp) GetName() string

GetName returns AppAgentRosterApp.Name, and is useful for accessing the field via an interface.

func (*AppAgentRosterApp) GetUrn added in v0.9.0 

func (v *AppAgentRosterApp) GetUrn() string

GetUrn returns AppAgentRosterApp.Urn, and is useful for accessing the field via an interface.

type AppAgentRosterAppAgentsAgent added in v0.9.0 

type AppAgentRosterAppAgentsAgent struct {
	Id             string          `json:"id"`
	Urn            string          `json:"urn"`
	Name           string          `json:"name"`
	Description    *string         `json:"description"`
	Visibility     AgentVisibility `json:"visibility"`
	OrganizationId *string         `json:"organizationId"`
	// Persona role - free string with conventions ('backend-engineer').
	PersonaRole *string `json:"personaRole"`
	CreatedAt   string  `json:"createdAt"`
}

AppAgentRosterAppAgentsAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*AppAgentRosterAppAgentsAgent) GetCreatedAt added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetCreatedAt() string

GetCreatedAt returns AppAgentRosterAppAgentsAgent.CreatedAt, and is useful for accessing the field via an interface.

func (*AppAgentRosterAppAgentsAgent) GetDescription added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetDescription() *string

GetDescription returns AppAgentRosterAppAgentsAgent.Description, and is useful for accessing the field via an interface.

func (*AppAgentRosterAppAgentsAgent) GetId added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetId() string

GetId returns AppAgentRosterAppAgentsAgent.Id, and is useful for accessing the field via an interface.

func (*AppAgentRosterAppAgentsAgent) GetName added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetName() string

GetName returns AppAgentRosterAppAgentsAgent.Name, and is useful for accessing the field via an interface.

func (*AppAgentRosterAppAgentsAgent) GetOrganizationId added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetOrganizationId() *string

GetOrganizationId returns AppAgentRosterAppAgentsAgent.OrganizationId, and is useful for accessing the field via an interface.

func (*AppAgentRosterAppAgentsAgent) GetPersonaRole added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetPersonaRole() *string

GetPersonaRole returns AppAgentRosterAppAgentsAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*AppAgentRosterAppAgentsAgent) GetUrn added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetUrn() string

GetUrn returns AppAgentRosterAppAgentsAgent.Urn, and is useful for accessing the field via an interface.

func (*AppAgentRosterAppAgentsAgent) GetVisibility added in v0.9.0 

func (v *AppAgentRosterAppAgentsAgent) GetVisibility() AgentVisibility

GetVisibility returns AppAgentRosterAppAgentsAgent.Visibility, and is useful for accessing the field via an interface.

type AppAgentRosterResponse added in v0.9.0 

type AppAgentRosterResponse struct {
	// Fetch an App (member of the App's org, or platform ADMIN — the myApps
	// exposure bar; #473 relaxed this from org ADMIN for read parity with the
	// list).
	//
	// 'ref' accepts the entity's ID or URN.
	App *AppAgentRosterApp `json:"app"`
}

AppAgentRosterResponse is returned by AppAgentRoster on success.

func AppAgentRoster added in v0.9.0 

func AppAgentRoster(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
) (data_ *AppAgentRosterResponse, err_ error)

The install-roster read (#408, re-homed from team.graphql in #428): the AppAgent join answering "which Agents are installed in this App?". Under the Worker model this is the INSTALL roster only — the App's STAFF (named workers) is the Workers query in team.graphql. App.agents is the 023-app-shape convenience over App.appAgents, so this needs no paging: an App's installed set is small and bounded, unlike agents().

func (*AppAgentRosterResponse) GetApp added in v0.9.0 

func (v *AppAgentRosterResponse) GetApp() *AppAgentRosterApp

GetApp returns AppAgentRosterResponse.App, and is useful for accessing the field via an interface.

type AppFilter added in v0.15.0 

type AppFilter struct {
	// #782 — true restricts the list to the caller's OWN user-owned (org-less)
	// apps: organizationId IS NULL AND ownerUserId = the caller. For ALL callers
	// INCLUDING platform ADMIN/OWNER (owner scope is never an admin-bypass
	// surface), mirroring the owner-only personal/private memories slice.
	// Org-less by definition, so orgId is not consulted. App-key callers (no
	// user context) get an empty page. Powers the portal's "My apps".
	OwnedByMe *bool `json:"ownedByMe,omitempty"`
}

Filter for the uniform apps() list (#473). Clauses AND-combine.

func (*AppFilter) GetOwnedByMe added in v0.15.0 

func (v *AppFilter) GetOwnedByMe() *bool

GetOwnedByMe returns AppFilter.OwnedByMe, and is useful for accessing the field via an interface.

type AppRunAppRun added in v0.6.0 

type AppRunAppRun struct {
	AppRunFields `json:"-"`
}

AppRunAppRun includes the requested fields of the GraphQL type AppRun. The GraphQL type's documentation follows.

One headless run — the audit record AND (v1) the activation: policy snapshot, live budgets (zeroing halts the run), lifecycle, trigger provenance. Spec cor:agt:010:02.

func (*AppRunAppRun) GetAgentId added in v0.6.0 

func (v *AppRunAppRun) GetAgentId() *string

GetAgentId returns AppRunAppRun.AgentId, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetAppId added in v0.6.0 

func (v *AppRunAppRun) GetAppId() string

GetAppId returns AppRunAppRun.AppId, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetAttempts added in v0.6.0 

func (v *AppRunAppRun) GetAttempts() int

GetAttempts returns AppRunAppRun.Attempts, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetBudgetActions added in v0.6.0 

func (v *AppRunAppRun) GetBudgetActions() *int

GetBudgetActions returns AppRunAppRun.BudgetActions, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetBudgetTokens added in v0.6.0 

func (v *AppRunAppRun) GetBudgetTokens() *int

GetBudgetTokens returns AppRunAppRun.BudgetTokens, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetCreatedAt added in v0.6.0 

func (v *AppRunAppRun) GetCreatedAt() string

GetCreatedAt returns AppRunAppRun.CreatedAt, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetCreatedBy added in v0.6.0 

func (v *AppRunAppRun) GetCreatedBy() *string

GetCreatedBy returns AppRunAppRun.CreatedBy, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetCurNodeUrn added in v0.6.0 

func (v *AppRunAppRun) GetCurNodeUrn() *string

GetCurNodeUrn returns AppRunAppRun.CurNodeUrn, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetData added in v0.7.0 

func (v *AppRunAppRun) GetData() *json.RawMessage

GetData returns AppRunAppRun.Data, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetEntryNodeUrn added in v0.6.0 

func (v *AppRunAppRun) GetEntryNodeUrn() string

GetEntryNodeUrn returns AppRunAppRun.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetEventData added in v0.6.0 

func (v *AppRunAppRun) GetEventData() *json.RawMessage

GetEventData returns AppRunAppRun.EventData, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetFailure added in v0.6.0 

func (v *AppRunAppRun) GetFailure() *json.RawMessage

GetFailure returns AppRunAppRun.Failure, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetFinishedAt added in v0.6.0 

func (v *AppRunAppRun) GetFinishedAt() *string

GetFinishedAt returns AppRunAppRun.FinishedAt, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetId added in v0.6.0 

func (v *AppRunAppRun) GetId() string

GetId returns AppRunAppRun.Id, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetOrganizationId added in v0.6.0 

func (v *AppRunAppRun) GetOrganizationId() string

GetOrganizationId returns AppRunAppRun.OrganizationId, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetParentRunId added in v0.6.0 

func (v *AppRunAppRun) GetParentRunId() *string

GetParentRunId returns AppRunAppRun.ParentRunId, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetPolicy added in v0.6.0 

func (v *AppRunAppRun) GetPolicy() *json.RawMessage

GetPolicy returns AppRunAppRun.Policy, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetStartedAt added in v0.6.0 

func (v *AppRunAppRun) GetStartedAt() *string

GetStartedAt returns AppRunAppRun.StartedAt, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetStatus added in v0.6.0 

func (v *AppRunAppRun) GetStatus() AppRunStatus

GetStatus returns AppRunAppRun.Status, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetTimeoutMs added in v0.6.0 

func (v *AppRunAppRun) GetTimeoutMs() *int

GetTimeoutMs returns AppRunAppRun.TimeoutMs, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetTriggerId added in v0.6.0 

func (v *AppRunAppRun) GetTriggerId() *string

GetTriggerId returns AppRunAppRun.TriggerId, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetTriggerKind added in v0.6.0 

func (v *AppRunAppRun) GetTriggerKind() AppRunTriggerKind

GetTriggerKind returns AppRunAppRun.TriggerKind, and is useful for accessing the field via an interface.

func (*AppRunAppRun) GetUserId added in v0.6.0 

func (v *AppRunAppRun) GetUserId() *string

GetUserId returns AppRunAppRun.UserId, and is useful for accessing the field via an interface.

func (*AppRunAppRun) MarshalJSON added in v0.6.0 

func (v *AppRunAppRun) MarshalJSON() ([]byte, error)

func (*AppRunAppRun) UnmarshalJSON added in v0.6.0 

func (v *AppRunAppRun) UnmarshalJSON(b []byte) error

type AppRunFields added in v0.6.0 

type AppRunFields struct {
	Id             string            `json:"id"`
	OrganizationId string            `json:"organizationId"`
	AppId          string            `json:"appId"`
	AgentId        *string           `json:"agentId"`
	Status         AppRunStatus      `json:"status"`
	TriggerKind    AppRunTriggerKind `json:"triggerKind"`
	TriggerId      *string           `json:"triggerId"`
	EntryNodeUrn   string            `json:"entryNodeUrn"`
	CurNodeUrn     *string           `json:"curNodeUrn"`
	// On-behalf-of user (cor:agt:010:01). Null = pure App service identity.
	UserId      *string `json:"userId"`
	CreatedBy   *string `json:"createdBy"`
	ParentRunId *string `json:"parentRunId"`
	Attempts    int     `json:"attempts"`
	// Remaining action budget — live-decremented per write/tool action.
	BudgetActions *int `json:"budgetActions"`
	// Remaining LLM-token budget — live-decremented; zero halts the run.
	BudgetTokens *int             `json:"budgetTokens"`
	TimeoutMs    *int             `json:"timeoutMs"`
	Policy       *json.RawMessage `json:"policy"`
	EventData    *json.RawMessage `json:"eventData"`
	// The run envelope (plan-multi-node D-MN-1): fields extracted by flow nodes as the walker advances. eventData stays the immutable trigger payload; on key collision the envelope wins.
	Data       *json.RawMessage `json:"data"`
	Failure    *json.RawMessage `json:"failure"`
	CreatedAt  string           `json:"createdAt"`
	StartedAt  *string          `json:"startedAt"`
	FinishedAt *string          `json:"finishedAt"`
}

AppRunFields includes the GraphQL fields of AppRun requested by the fragment AppRunFields. The GraphQL type's documentation follows.

One headless run — the audit record AND (v1) the activation: policy snapshot, live budgets (zeroing halts the run), lifecycle, trigger provenance. Spec cor:agt:010:02.

func (*AppRunFields) GetAgentId added in v0.6.0 

func (v *AppRunFields) GetAgentId() *string

GetAgentId returns AppRunFields.AgentId, and is useful for accessing the field via an interface.

func (*AppRunFields) GetAppId added in v0.6.0 

func (v *AppRunFields) GetAppId() string

GetAppId returns AppRunFields.AppId, and is useful for accessing the field via an interface.

func (*AppRunFields) GetAttempts added in v0.6.0 

func (v *AppRunFields) GetAttempts() int

GetAttempts returns AppRunFields.Attempts, and is useful for accessing the field via an interface.

func (*AppRunFields) GetBudgetActions added in v0.6.0 

func (v *AppRunFields) GetBudgetActions() *int

GetBudgetActions returns AppRunFields.BudgetActions, and is useful for accessing the field via an interface.

func (*AppRunFields) GetBudgetTokens added in v0.6.0 

func (v *AppRunFields) GetBudgetTokens() *int

GetBudgetTokens returns AppRunFields.BudgetTokens, and is useful for accessing the field via an interface.

func (*AppRunFields) GetCreatedAt added in v0.6.0 

func (v *AppRunFields) GetCreatedAt() string

GetCreatedAt returns AppRunFields.CreatedAt, and is useful for accessing the field via an interface.

func (*AppRunFields) GetCreatedBy added in v0.6.0 

func (v *AppRunFields) GetCreatedBy() *string

GetCreatedBy returns AppRunFields.CreatedBy, and is useful for accessing the field via an interface.

func (*AppRunFields) GetCurNodeUrn added in v0.6.0 

func (v *AppRunFields) GetCurNodeUrn() *string

GetCurNodeUrn returns AppRunFields.CurNodeUrn, and is useful for accessing the field via an interface.

func (*AppRunFields) GetData added in v0.7.0 

func (v *AppRunFields) GetData() *json.RawMessage

GetData returns AppRunFields.Data, and is useful for accessing the field via an interface.

func (*AppRunFields) GetEntryNodeUrn added in v0.6.0 

func (v *AppRunFields) GetEntryNodeUrn() string

GetEntryNodeUrn returns AppRunFields.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AppRunFields) GetEventData added in v0.6.0 

func (v *AppRunFields) GetEventData() *json.RawMessage

GetEventData returns AppRunFields.EventData, and is useful for accessing the field via an interface.

func (*AppRunFields) GetFailure added in v0.6.0 

func (v *AppRunFields) GetFailure() *json.RawMessage

GetFailure returns AppRunFields.Failure, and is useful for accessing the field via an interface.

func (*AppRunFields) GetFinishedAt added in v0.6.0 

func (v *AppRunFields) GetFinishedAt() *string

GetFinishedAt returns AppRunFields.FinishedAt, and is useful for accessing the field via an interface.

func (*AppRunFields) GetId added in v0.6.0 

func (v *AppRunFields) GetId() string

GetId returns AppRunFields.Id, and is useful for accessing the field via an interface.

func (*AppRunFields) GetOrganizationId added in v0.6.0 

func (v *AppRunFields) GetOrganizationId() string

GetOrganizationId returns AppRunFields.OrganizationId, and is useful for accessing the field via an interface.

func (*AppRunFields) GetParentRunId added in v0.6.0 

func (v *AppRunFields) GetParentRunId() *string

GetParentRunId returns AppRunFields.ParentRunId, and is useful for accessing the field via an interface.

func (*AppRunFields) GetPolicy added in v0.6.0 

func (v *AppRunFields) GetPolicy() *json.RawMessage

GetPolicy returns AppRunFields.Policy, and is useful for accessing the field via an interface.

func (*AppRunFields) GetStartedAt added in v0.6.0 

func (v *AppRunFields) GetStartedAt() *string

GetStartedAt returns AppRunFields.StartedAt, and is useful for accessing the field via an interface.

func (*AppRunFields) GetStatus added in v0.6.0 

func (v *AppRunFields) GetStatus() AppRunStatus

GetStatus returns AppRunFields.Status, and is useful for accessing the field via an interface.

func (*AppRunFields) GetTimeoutMs added in v0.6.0 

func (v *AppRunFields) GetTimeoutMs() *int

GetTimeoutMs returns AppRunFields.TimeoutMs, and is useful for accessing the field via an interface.

func (*AppRunFields) GetTriggerId added in v0.6.0 

func (v *AppRunFields) GetTriggerId() *string

GetTriggerId returns AppRunFields.TriggerId, and is useful for accessing the field via an interface.

func (*AppRunFields) GetTriggerKind added in v0.6.0 

func (v *AppRunFields) GetTriggerKind() AppRunTriggerKind

GetTriggerKind returns AppRunFields.TriggerKind, and is useful for accessing the field via an interface.

func (*AppRunFields) GetUserId added in v0.6.0 

func (v *AppRunFields) GetUserId() *string

GetUserId returns AppRunFields.UserId, and is useful for accessing the field via an interface.

type AppRunResponse added in v0.6.0 

type AppRunResponse struct {
	// One run (cor:agt:010:02). ref is an AppRun ID or an
	// hrn:apprun:<root>:<app>:<run-id> URN (#696). Readable by a platform admin,
	// a READER of the run's organization, the run's own App key, or a user with a
	// live App relationship for a run on their behalf or a MANUAL run they
	// started. A run the caller may not read returns null, exactly like a
	// missing one (#1577: no existence oracle).
	AppRun *AppRunAppRun `json:"appRun"`
}

AppRunResponse is returned by AppRun on success.

func AppRun added in v0.6.0 

func AppRun(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *AppRunResponse, err_ error)

Single-run detail; null when absent/denied (anti-enumeration).

func (*AppRunResponse) GetAppRun added in v0.6.0 

func (v *AppRunResponse) GetAppRun() *AppRunAppRun

GetAppRun returns AppRunResponse.AppRun, and is useful for accessing the field via an interface.

type AppRunStatus added in v0.6.0 

type AppRunStatus string
const (
	AppRunStatusCancelled AppRunStatus = "CANCELLED"
	AppRunStatusCompleted AppRunStatus = "COMPLETED"
	AppRunStatusFailed    AppRunStatus = "FAILED"
	AppRunStatusPending   AppRunStatus = "PENDING"
	AppRunStatusRunning   AppRunStatus = "RUNNING"
	AppRunStatusTimedOut  AppRunStatus = "TIMED_OUT"
)

type AppRunTriggerKind added in v0.6.0 

type AppRunTriggerKind string
const (
	AppRunTriggerKindIntegration AppRunTriggerKind = "INTEGRATION"
	AppRunTriggerKindManual      AppRunTriggerKind = "MANUAL"
	AppRunTriggerKindSchedule    AppRunTriggerKind = "SCHEDULE"
	AppRunTriggerKindSpawn       AppRunTriggerKind = "SPAWN"
	AppRunTriggerKindWebhook     AppRunTriggerKind = "WEBHOOK"
)

type AppRunsAppRunsAppRunsPage added in v0.6.0 

type AppRunsAppRunsAppRunsPage struct {
	Total int                                     `json:"total"`
	Items []*AppRunsAppRunsAppRunsPageItemsAppRun `json:"items"`
}

AppRunsAppRunsAppRunsPage includes the requested fields of the GraphQL type AppRunsPage.

func (*AppRunsAppRunsAppRunsPage) GetItems added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPage) GetItems() []*AppRunsAppRunsAppRunsPageItemsAppRun

GetItems returns AppRunsAppRunsAppRunsPage.Items, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPage) GetTotal added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPage) GetTotal() int

GetTotal returns AppRunsAppRunsAppRunsPage.Total, and is useful for accessing the field via an interface.

type AppRunsAppRunsAppRunsPageItemsAppRun added in v0.6.0 

type AppRunsAppRunsAppRunsPageItemsAppRun struct {
	AppRunFields `json:"-"`
}

AppRunsAppRunsAppRunsPageItemsAppRun includes the requested fields of the GraphQL type AppRun. The GraphQL type's documentation follows.

One headless run — the audit record AND (v1) the activation: policy snapshot, live budgets (zeroing halts the run), lifecycle, trigger provenance. Spec cor:agt:010:02.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetAgentId added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetAgentId() *string

GetAgentId returns AppRunsAppRunsAppRunsPageItemsAppRun.AgentId, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetAppId added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetAppId() string

GetAppId returns AppRunsAppRunsAppRunsPageItemsAppRun.AppId, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetAttempts added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetAttempts() int

GetAttempts returns AppRunsAppRunsAppRunsPageItemsAppRun.Attempts, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetBudgetActions added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetBudgetActions() *int

GetBudgetActions returns AppRunsAppRunsAppRunsPageItemsAppRun.BudgetActions, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetBudgetTokens added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetBudgetTokens() *int

GetBudgetTokens returns AppRunsAppRunsAppRunsPageItemsAppRun.BudgetTokens, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetCreatedAt added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetCreatedAt() string

GetCreatedAt returns AppRunsAppRunsAppRunsPageItemsAppRun.CreatedAt, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetCreatedBy added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetCreatedBy() *string

GetCreatedBy returns AppRunsAppRunsAppRunsPageItemsAppRun.CreatedBy, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetCurNodeUrn added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetCurNodeUrn() *string

GetCurNodeUrn returns AppRunsAppRunsAppRunsPageItemsAppRun.CurNodeUrn, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetData added in v0.7.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetData() *json.RawMessage

GetData returns AppRunsAppRunsAppRunsPageItemsAppRun.Data, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetEntryNodeUrn added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetEntryNodeUrn() string

GetEntryNodeUrn returns AppRunsAppRunsAppRunsPageItemsAppRun.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetEventData added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetEventData() *json.RawMessage

GetEventData returns AppRunsAppRunsAppRunsPageItemsAppRun.EventData, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetFailure added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetFailure() *json.RawMessage

GetFailure returns AppRunsAppRunsAppRunsPageItemsAppRun.Failure, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetFinishedAt added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetFinishedAt() *string

GetFinishedAt returns AppRunsAppRunsAppRunsPageItemsAppRun.FinishedAt, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetId added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetId() string

GetId returns AppRunsAppRunsAppRunsPageItemsAppRun.Id, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetOrganizationId added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetOrganizationId() string

GetOrganizationId returns AppRunsAppRunsAppRunsPageItemsAppRun.OrganizationId, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetParentRunId added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetParentRunId() *string

GetParentRunId returns AppRunsAppRunsAppRunsPageItemsAppRun.ParentRunId, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetPolicy added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetPolicy() *json.RawMessage

GetPolicy returns AppRunsAppRunsAppRunsPageItemsAppRun.Policy, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetStartedAt added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetStartedAt() *string

GetStartedAt returns AppRunsAppRunsAppRunsPageItemsAppRun.StartedAt, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetStatus added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetStatus() AppRunStatus

GetStatus returns AppRunsAppRunsAppRunsPageItemsAppRun.Status, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetTimeoutMs added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetTimeoutMs() *int

GetTimeoutMs returns AppRunsAppRunsAppRunsPageItemsAppRun.TimeoutMs, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetTriggerId added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetTriggerId() *string

GetTriggerId returns AppRunsAppRunsAppRunsPageItemsAppRun.TriggerId, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetTriggerKind added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetTriggerKind() AppRunTriggerKind

GetTriggerKind returns AppRunsAppRunsAppRunsPageItemsAppRun.TriggerKind, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) GetUserId added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) GetUserId() *string

GetUserId returns AppRunsAppRunsAppRunsPageItemsAppRun.UserId, and is useful for accessing the field via an interface.

func (*AppRunsAppRunsAppRunsPageItemsAppRun) MarshalJSON added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) MarshalJSON() ([]byte, error)

func (*AppRunsAppRunsAppRunsPageItemsAppRun) UnmarshalJSON added in v0.6.0 

func (v *AppRunsAppRunsAppRunsPageItemsAppRun) UnmarshalJSON(b []byte) error

type AppRunsResponse added in v0.6.0 

type AppRunsResponse struct {
	// The run audit list.
	//
	// statuses (#836) is a disjunction — 'everything still in flight' is
	// [PENDING, RUNNING] and 'what went wrong' is [FAILED, TIMED_OUT], neither of
	// which the single-valued status arg could express. Per
	// conventions:multi-ref-scope-args: OMITTING it means no status filter, while
	// an explicitly EMPTY list is the EMPTY scope and returns nothing - it never
	// silently falls back to 'all'. Values are deduped; an unknown member is
	// rejected by enum validation rather than dropped.
	//
	// status is DEPRECATED in favour of statuses. Both are accepted for one
	// release; when both are given, statuses wins.
	//
	// sortBy / sortDir (#833) order the whole result set server-side, so a client
	// table is no longer limited to sorting the page it happens to hold.
	AppRuns *AppRunsAppRunsAppRunsPage `json:"appRuns"`
}

AppRunsResponse is returned by AppRuns on success.

func AppRuns added in v0.6.0 

func AppRuns(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef *string,
	orgRef *string,
	status *AppRunStatus,
	limit *int,
	offset *int,
) (data_ *AppRunsResponse, err_ error)

Paged { items, total } envelope (#473). appRef/orgRef/status all optional filters; `run ls` pages to exhaustion.

func (*AppRunsResponse) GetAppRuns added in v0.6.0 

func (v *AppRunsResponse) GetAppRuns() *AppRunsAppRunsAppRunsPage

GetAppRuns returns AppRunsResponse.AppRuns, and is useful for accessing the field via an interface.

type AppType 

type AppType string
const (
	AppTypeAgent       AppType = "AGENT"
	AppTypeAutomation  AppType = "AUTOMATION"
	AppTypeChatbot     AppType = "CHATBOT"
	AppTypeCloud       AppType = "CLOUD"
	AppTypeIot         AppType = "IOT"
	AppTypeWorkstation AppType = "WORKSTATION"
)

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult added in v0.19.0 

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult struct {
	MemoryId string                                                                                                       `json:"memoryId"`
	Template *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate `json:"template"`
	// The template revision that was applied; pass it back as expectedTemplateRevision to apply exactly what a dry run showed.
	TemplateRevision int  `json:"templateRevision"`
	Required         bool `json:"required"`
	DryRun           bool `json:"dryRun"`
	// One per template rule, role-ascending.
	Entries []*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry `json:"entries"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning `json:"warnings"`
}

ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult includes the requested fields of the GraphQL type MemoryConfigApplyResult.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetDryRun added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetDryRun() bool

GetDryRun returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult.DryRun, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetEntries added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetEntries() []*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry

GetEntries returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult.Entries, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetMemoryId added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetMemoryId() string

GetMemoryId returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult.MemoryId, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetRequired added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetRequired() bool

GetRequired returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult.Required, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetTemplate added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetTemplate() *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate

GetTemplate returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult.Template, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetTemplateRevision added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetTemplateRevision() int

GetTemplateRevision returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult.TemplateRevision, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetWarnings added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult) GetWarnings() []*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning

GetWarnings returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult.Warnings, and is useful for accessing the field via an interface.

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry added in v0.19.0 

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry struct {
	Role    string                   `json:"role"`
	Outcome MemoryConfigApplyOutcome `json:"outcome"`
	// The rule in force for this role afterwards. On a dry run, the existing rule, or null for a would-be APPLIED.
	Rule *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule `json:"rule"`
}

ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry includes the requested fields of the GraphQL type MemoryConfigApplyEntry.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry) GetOutcome added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry) GetOutcome() MemoryConfigApplyOutcome

GetOutcome returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry.Outcome, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry) GetRole added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry) GetRole() string

GetRole returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry.Role, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry) GetRule added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry) GetRule() *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule

GetRule returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntry.Rule, and is useful for accessing the field via an interface.

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule added in v0.19.0 

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule struct {
	NodeRoleRuleFields `json:"-"`
}

ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule includes the requested fields of the GraphQL type NodeRoleRule. The GraphQL type's documentation follows.

#1325 — one node-role rule. Task and description references are stored by node id (they survive moves) and returned as a URN and an id, each with its state. Both are given only when the state is OK; see NodeRoleRuleRefState.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetAuthorTask added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetAuthorTask() *string

GetAuthorTask returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.AuthorTask, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetAuthorTaskId added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetAuthorTaskId() *string

GetAuthorTaskId returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.AuthorTaskId, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetAuthorTaskState added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.AuthorTaskState, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetCreatedAt added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetCreatedAt() string

GetCreatedAt returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.CreatedAt, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetCreatedBy added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetCreatedBy() *string

GetCreatedBy returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.CreatedBy, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetDescriptionNode added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetDescriptionNode() *string

GetDescriptionNode returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.DescriptionNode, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetDescriptionNodeId added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetDescriptionNodeId() *string

GetDescriptionNodeId returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetDescriptionNodeState added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetEnabled added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetEnabled() bool

GetEnabled returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.Enabled, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetId added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetId() string

GetId returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.Id, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetLocked added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetLocked() bool

GetLocked returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.Locked, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetRevision added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetRevision() int

GetRevision returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.Revision, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetRole added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetRole() string

GetRole returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.Role, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetSourceTemplate added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetSourceTemplate() *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate

GetSourceTemplate returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.SourceTemplate, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetSourceTemplateId added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetSourceTemplateId() *string

GetSourceTemplateId returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.SourceTemplateId, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetStrictSubRoles added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetStrictSubRoles() bool

GetStrictSubRoles returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.StrictSubRoles, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetUpdatedAt added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetUpdatedAt() *string

GetUpdatedAt returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.UpdatedAt, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetUpdatedBy added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetUpdatedBy() *string

GetUpdatedBy returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.UpdatedBy, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidateBy added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidateBy() *ContentValidator

GetValidateBy returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.ValidateBy, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidationTask added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidationTask() *string

GetValidationTask returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.ValidationTask, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidationTaskId added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidationTaskId() *string

GetValidationTaskId returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.ValidationTaskId, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidationTaskState added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.ValidationTaskState, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetWriters added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) GetWriters() NodeRoleWriters

GetWriters returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule.Writers, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) MarshalJSON added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) MarshalJSON() ([]byte, error)

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) UnmarshalJSON added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultEntriesMemoryConfigApplyEntryRuleNodeRoleRule) UnmarshalJSON(b []byte) error

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate added in v0.19.0 

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate struct {
	Id   string `json:"id"`
	Name string `json:"name"`
	// The template has been deleted; the rule keeps its copy.
	Deleted bool `json:"deleted"`
}

ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate includes the requested fields of the GraphQL type NodeRoleRuleSourceTemplate.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate) GetDeleted added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate) GetDeleted() bool

GetDeleted returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate.Deleted, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate) GetId added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate) GetId() string

GetId returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate.Id, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate) GetName added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate) GetName() string

GetName returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultTemplateNodeRoleRuleSourceTemplate.Name, and is useful for accessing the field via an interface.

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning added in v0.19.0 

type ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetCode added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetCode() string

GetCode returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetField added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetField() *string

GetField returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetRole added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetRole() string

GetRole returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetTaskState added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetTaskUrn added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) MarshalJSON added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) UnmarshalJSON added in v0.19.0 

func (v *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResultWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type ApplyMemoryConfigTemplateResponse added in v0.19.0 

type ApplyMemoryConfigTemplateResponse struct {
	// #1334 — copy a template's rules into ONE memory's config. A one-off copy:
	// later template edits never reach this memory, and re-applying is explicit.
	//
	// Needs MANAGE on the memory (else MemoryNotFound) and on the template,
	// which exists for you only if you manage its owner (else
	// MEMORY_CONFIG_TEMPLATE_NOT_FOUND). The rules are validated as a whole,
	// under a share lock, as createNodeRoleRule validates a new rule's
	// references (NODE_NOT_FOUND for one you cannot read, NOT_A_TASK), and a
	// template rule whose task was deleted refuses the whole apply
	// (NODE_ROLE_RULE_REF_BROKEN). All-or-nothing per memory.
	//
	// When the memory already has a rule for a role, a non-required template
	// skips it and a required template replaces it. A LOCKED rule is only
	// replaced by a caller with lock authority (see unlockNodeRoleRule);
	// otherwise SKIPPED_LOCKED. Rules written by a required template are locked.
	//
	// expectedTemplateRevision: CONFLICT (with currentRevision) if the template
	// changed since you read it. dryRun: the same report with nothing written.
	ApplyMemoryConfigTemplate *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult `json:"applyMemoryConfigTemplate"`
}

ApplyMemoryConfigTemplateResponse is returned by ApplyMemoryConfigTemplate on success.

func ApplyMemoryConfigTemplate added in v0.19.0 

func ApplyMemoryConfigTemplate(
	ctx_ context.Context,
	client_ graphql.Client,
	templateRef string,
	memoryRef string,
	expectedTemplateRevision *int,
	dryRun bool,
) (data_ *ApplyMemoryConfigTemplateResponse, err_ error)

#716 slice 3 / server#1334 — copy a template's rules into ONE memory's config. A one-off copy (later template edits never reach the memory). The report has one entry per template rule: APPLIED, SKIPPED_CONFLICT (a non-required template never overrides), REPLACED (a required template overwrote the rule, now locked) or SKIPPED_LOCKED. `template apply` dry-runs first and, when the preview would REPLACE a rule, confirms before applying with the preview's templateRevision as expectedTemplateRevision, so what was shown is what is applied (CONFLICT otherwise).

func (*ApplyMemoryConfigTemplateResponse) GetApplyMemoryConfigTemplate added in v0.19.0 

func (v *ApplyMemoryConfigTemplateResponse) GetApplyMemoryConfigTemplate() *ApplyMemoryConfigTemplateApplyMemoryConfigTemplateMemoryConfigApplyResult

GetApplyMemoryConfigTemplate returns ApplyMemoryConfigTemplateResponse.ApplyMemoryConfigTemplate, and is useful for accessing the field via an interface.

type ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult added in v0.19.0 

type ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult struct {
	ApprovedCount int `json:"approvedCount"`
	// Nodes whose current revision was already approved (left unchanged).
	AlreadyApprovedCount int `json:"alreadyApprovedCount"`
	// Locs of reserved placeholders, which have no spec to approve yet.
	SkippedPlaceholders []string `json:"skippedPlaceholders"`
	// Nodes newly approved by this call, ordered by loc.
	Approved []*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt `json:"approved"`
}

ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult includes the requested fields of the GraphQL type ApproveMemoryNodesResult. The GraphQL type's documentation follows.

#1591 — the outcome of approving every node of a memory.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetAlreadyApprovedCount added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetAlreadyApprovedCount() int

GetAlreadyApprovedCount returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult.AlreadyApprovedCount, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetApproved added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetApproved() []*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt

GetApproved returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult.Approved, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetApprovedCount added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetApprovedCount() int

GetApprovedCount returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult.ApprovedCount, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetSkippedPlaceholders added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult) GetSkippedPlaceholders() []string

GetSkippedPlaceholders returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult.SkippedPlaceholders, and is useful for accessing the field via an interface.

type ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt added in v0.19.0 

type ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt struct {
	NodeId   string                                                                                                       `json:"nodeId"`
	Urn      string                                                                                                       `json:"urn"`
	Loc      string                                                                                                       `json:"loc"`
	Approval *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval `json:"approval"`
}

ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt includes the requested fields of the GraphQL type NodeApprovalReceipt. The GraphQL type's documentation follows.

#1591 — a node and its approval, returned by the approve mutations.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetApproval added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetApproval() *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval

GetApproval returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt.Approval, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetLoc added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetLoc() string

GetLoc returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt.Loc, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetNodeId added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetNodeId() string

GetNodeId returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt.NodeId, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetUrn added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt) GetUrn() string

GetUrn returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceipt.Urn, and is useful for accessing the field via an interface.

type ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval added in v0.19.0 

type ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval struct {
	NodeApprovalFields `json:"-"`
}

ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval includes the requested fields of the GraphQL type NodeApproval. The GraphQL type's documentation follows.

#1591 — one recorded approval of a node revision.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetApprovedAt added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetApprovedAt() string

GetApprovedAt returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval.ApprovedAt, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetApprovedBy added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetApprovedBy() *NodeApprovalFieldsApprovedByNodeRevisionEditor

GetApprovedBy returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval.ApprovedBy, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetApprovedByInfo added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetApprovedByInfo() *string

GetApprovedByInfo returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval.ApprovedByInfo, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetHash added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetHash() string

GetHash returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval.Hash, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetRevision added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) GetRevision() int

GetRevision returns ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval.Revision, and is useful for accessing the field via an interface.

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) MarshalJSON added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) MarshalJSON() ([]byte, error)

func (*ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) UnmarshalJSON added in v0.19.0 

func (v *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResultApprovedNodeApprovalReceiptApprovalNodeApproval) UnmarshalJSON(b []byte) error

type ApproveMemoryNodesResponse added in v0.19.0 

type ApproveMemoryNodesResponse struct {
	// #1591 — approve the current revision of every live, unminted node of a memory (ID or fully-qualified URN) that isn't approved yet, in one transaction. Placeholders are skipped and reported.
	ApproveMemoryNodes *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult `json:"approveMemoryNodes"`
}

ApproveMemoryNodesResponse is returned by ApproveMemoryNodes on success.

func ApproveMemoryNodes added in v0.19.0 

func ApproveMemoryNodes(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
) (data_ *ApproveMemoryNodesResponse, err_ error)

func (*ApproveMemoryNodesResponse) GetApproveMemoryNodes added in v0.19.0 

func (v *ApproveMemoryNodesResponse) GetApproveMemoryNodes() *ApproveMemoryNodesApproveMemoryNodesApproveMemoryNodesResult

GetApproveMemoryNodes returns ApproveMemoryNodesResponse.ApproveMemoryNodes, and is useful for accessing the field via an interface.

type ApproveNodeApproveNodeNodeApprovalReceipt added in v0.19.0 

type ApproveNodeApproveNodeNodeApprovalReceipt struct {
	NodeId   string                                                         `json:"nodeId"`
	Urn      string                                                         `json:"urn"`
	Loc      string                                                         `json:"loc"`
	Approval *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval `json:"approval"`
}

ApproveNodeApproveNodeNodeApprovalReceipt includes the requested fields of the GraphQL type NodeApprovalReceipt. The GraphQL type's documentation follows.

#1591 — a node and its approval, returned by the approve mutations.

func (*ApproveNodeApproveNodeNodeApprovalReceipt) GetApproval added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceipt) GetApproval() *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval

GetApproval returns ApproveNodeApproveNodeNodeApprovalReceipt.Approval, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceipt) GetLoc added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceipt) GetLoc() string

GetLoc returns ApproveNodeApproveNodeNodeApprovalReceipt.Loc, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceipt) GetNodeId added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceipt) GetNodeId() string

GetNodeId returns ApproveNodeApproveNodeNodeApprovalReceipt.NodeId, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceipt) GetUrn added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceipt) GetUrn() string

GetUrn returns ApproveNodeApproveNodeNodeApprovalReceipt.Urn, and is useful for accessing the field via an interface.

type ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval added in v0.19.0 

type ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval struct {
	NodeApprovalFields `json:"-"`
}

ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval includes the requested fields of the GraphQL type NodeApproval. The GraphQL type's documentation follows.

#1591 — one recorded approval of a node revision.

func (*ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetApprovedAt added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetApprovedAt() string

GetApprovedAt returns ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval.ApprovedAt, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetApprovedBy added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetApprovedBy() *NodeApprovalFieldsApprovedByNodeRevisionEditor

GetApprovedBy returns ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval.ApprovedBy, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetApprovedByInfo added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetApprovedByInfo() *string

GetApprovedByInfo returns ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval.ApprovedByInfo, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetHash added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetHash() string

GetHash returns ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval.Hash, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetRevision added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) GetRevision() int

GetRevision returns ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval.Revision, and is useful for accessing the field via an interface.

func (*ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) MarshalJSON added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) MarshalJSON() ([]byte, error)

func (*ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) UnmarshalJSON added in v0.19.0 

func (v *ApproveNodeApproveNodeNodeApprovalReceiptApprovalNodeApproval) UnmarshalJSON(b []byte) error

type ApproveNodeResponse added in v0.19.0 

type ApproveNodeResponse struct {
	// #1591 — approve the node's CURRENT revision: record who, when, and the
	// approval hash of its title/abstract/content. Pass revision to approve only
	// if it is still the one you read (REVISION_MISMATCH otherwise). Any writer of
	// the memory may approve, the author included. Idempotent: an approved
	// revision keeps its existing approval. Refuses NODE_IS_PLACEHOLDER, and
	// SESSION_EXPIRED on an encrypted memory without its session key.
	ApproveNode *ApproveNodeApproveNodeNodeApprovalReceipt `json:"approveNode"`
}

ApproveNodeResponse is returned by ApproveNode on success.

func ApproveNode added in v0.19.0 

func ApproveNode(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
	revision *int,
) (data_ *ApproveNodeResponse, err_ error)

func (*ApproveNodeResponse) GetApproveNode added in v0.19.0 

func (v *ApproveNodeResponse) GetApproveNode() *ApproveNodeApproveNodeNodeApprovalReceipt

GetApproveNode returns ApproveNodeResponse.ApproveNode, and is useful for accessing the field via an interface.

type AppsAppsAppsPage added in v0.5.1 

type AppsAppsAppsPage struct {
	Total int                         `json:"total"`
	Items []*AppsAppsAppsPageItemsApp `json:"items"`
}

AppsAppsAppsPage includes the requested fields of the GraphQL type AppsPage.

func (*AppsAppsAppsPage) GetItems added in v0.5.1 

func (v *AppsAppsAppsPage) GetItems() []*AppsAppsAppsPageItemsApp

GetItems returns AppsAppsAppsPage.Items, and is useful for accessing the field via an interface.

func (*AppsAppsAppsPage) GetTotal added in v0.5.1 

func (v *AppsAppsAppsPage) GetTotal() int

GetTotal returns AppsAppsAppsPage.Total, and is useful for accessing the field via an interface.

type AppsAppsAppsPageItemsApp added in v0.5.1 

type AppsAppsAppsPageItemsApp struct {
	Id      string  `json:"id"`
	Urn     string  `json:"urn"`
	Name    string  `json:"name"`
	AppType AppType `json:"appType"`
	// SOFT-DEPRECATED convenience read: the FIRST installed Agent. An App
	// installs MANY Agents through the `AppAgent` join (023-app-shape Phase 2b,
	// which DROPPED the direct FK that 008-agent-installation had introduced) —
	// see `appAgents` below for the real cardinality. Kept so single-Agent
	// clients keep working; do not build new multi-Agent logic on it.
	AgentId     *string `json:"agentId"`
	MemberCount int     `json:"memberCount"`
	CreatedAt   string  `json:"createdAt"`
}

AppsAppsAppsPageItemsApp includes the requested fields of the GraphQL type App. The GraphQL type's documentation follows.

A runtime caller identity owned by exactly one Organization or User. It owns long-lived App Keys and installs Agents through the AppAgent N:M join: one App may install many Agents, and one Agent may be installed in many Apps. The singular agentId / agent fields below are soft-deprecated convenience reads of the first install, not a direct foreign key.

func (*AppsAppsAppsPageItemsApp) GetAgentId added in v0.5.1 

func (v *AppsAppsAppsPageItemsApp) GetAgentId() *string

GetAgentId returns AppsAppsAppsPageItemsApp.AgentId, and is useful for accessing the field via an interface.

func (*AppsAppsAppsPageItemsApp) GetAppType added in v0.5.1 

func (v *AppsAppsAppsPageItemsApp) GetAppType() AppType

GetAppType returns AppsAppsAppsPageItemsApp.AppType, and is useful for accessing the field via an interface.

func (*AppsAppsAppsPageItemsApp) GetCreatedAt added in v0.5.1 

func (v *AppsAppsAppsPageItemsApp) GetCreatedAt() string

GetCreatedAt returns AppsAppsAppsPageItemsApp.CreatedAt, and is useful for accessing the field via an interface.

func (*AppsAppsAppsPageItemsApp) GetId added in v0.5.1 

func (v *AppsAppsAppsPageItemsApp) GetId() string

GetId returns AppsAppsAppsPageItemsApp.Id, and is useful for accessing the field via an interface.

func (*AppsAppsAppsPageItemsApp) GetMemberCount added in v0.5.1 

func (v *AppsAppsAppsPageItemsApp) GetMemberCount() int

GetMemberCount returns AppsAppsAppsPageItemsApp.MemberCount, and is useful for accessing the field via an interface.

func (*AppsAppsAppsPageItemsApp) GetName added in v0.5.1 

func (v *AppsAppsAppsPageItemsApp) GetName() string

GetName returns AppsAppsAppsPageItemsApp.Name, and is useful for accessing the field via an interface.

func (*AppsAppsAppsPageItemsApp) GetUrn added in v0.5.1 

func (v *AppsAppsAppsPageItemsApp) GetUrn() string

GetUrn returns AppsAppsAppsPageItemsApp.Urn, and is useful for accessing the field via an interface.

type AppsResponse 

type AppsResponse struct {
	// Uniform paginated app list (#473) — replaces the org-ADMIN apps(orgId!)
	// and the member myApps. Scope: Apps in the caller's member orgs (App
	// doesn't carry a userId, so org membership is the routing); platform
	// ADMIN/OWNER unscoped get every live App. orgId follows cor:api:100:01
	// (member -> scope, non-member -> empty page, no disclosure, no admin
	// bypass). Name-ascending order (id tiebreak); limit default 50 / cap 200;
	// limit: 0 -> count only. filter.ownedByMe (#782) narrows to the caller's own
	// user-owned (org-less) Apps for every caller including platform admins.
	Apps *AppsAppsAppsPage `json:"apps"`
}

AppsResponse is returned by Apps on success.

func Apps 

func Apps(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId *string,
	filter *AppFilter,
	limit *int,
	offset *int,
) (data_ *AppsResponse, err_ error)

Uniform paginated app list (hadron-server#473) — { items, total } envelope, limit capped at 200 server-side; `app ls` pages to exhaustion. orgId is NULLABLE on the server (#473's uniform list) and the owner slice is org-less by definition, so it must be omittable here — `app list` still requires one of --org / --owned-by-me, but that is the command's rule, not the operation's.

func (*AppsResponse) GetApps 

func (v *AppsResponse) GetApps() *AppsAppsAppsPage

GetApps returns AppsResponse.Apps, and is useful for accessing the field via an interface.

type AssetDownloadUrlAssetDownloadUrl added in v0.9.0 

type AssetDownloadUrlAssetDownloadUrl struct {
	Url       string `json:"url"`
	Filename  string `json:"filename"`
	MimeType  string `json:"mimeType"`
	SizeBytes int    `json:"sizeBytes"`
	ExpiresAt string `json:"expiresAt"`
}

AssetDownloadUrlAssetDownloadUrl includes the requested fields of the GraphQL type AssetDownloadUrl.

func (*AssetDownloadUrlAssetDownloadUrl) GetExpiresAt added in v0.9.0 

func (v *AssetDownloadUrlAssetDownloadUrl) GetExpiresAt() string

GetExpiresAt returns AssetDownloadUrlAssetDownloadUrl.ExpiresAt, and is useful for accessing the field via an interface.

func (*AssetDownloadUrlAssetDownloadUrl) GetFilename added in v0.9.0 

func (v *AssetDownloadUrlAssetDownloadUrl) GetFilename() string

GetFilename returns AssetDownloadUrlAssetDownloadUrl.Filename, and is useful for accessing the field via an interface.

func (*AssetDownloadUrlAssetDownloadUrl) GetMimeType added in v0.9.0 

func (v *AssetDownloadUrlAssetDownloadUrl) GetMimeType() string

GetMimeType returns AssetDownloadUrlAssetDownloadUrl.MimeType, and is useful for accessing the field via an interface.

func (*AssetDownloadUrlAssetDownloadUrl) GetSizeBytes added in v0.9.0 

func (v *AssetDownloadUrlAssetDownloadUrl) GetSizeBytes() int

GetSizeBytes returns AssetDownloadUrlAssetDownloadUrl.SizeBytes, and is useful for accessing the field via an interface.

func (*AssetDownloadUrlAssetDownloadUrl) GetUrl added in v0.9.0 

func (v *AssetDownloadUrlAssetDownloadUrl) GetUrl() string

GetUrl returns AssetDownloadUrlAssetDownloadUrl.Url, and is useful for accessing the field via an interface.

type AssetDownloadUrlResponse added in v0.9.0 

type AssetDownloadUrlResponse struct {
	// Mint a short-TTL presigned GET URL for an asset. Default TTL
	// 5 minutes; ceiling 1 hour. Gated on the holding memory's read
	// access and on scan_status = CLEAN.
	AssetDownloadUrl *AssetDownloadUrlAssetDownloadUrl `json:"assetDownloadUrl"`
}

AssetDownloadUrlResponse is returned by AssetDownloadUrl on success.

func AssetDownloadUrl added in v0.9.0 

func AssetDownloadUrl(
	ctx_ context.Context,
	client_ graphql.Client,
	assetId string,
	ttlSeconds *int,
) (data_ *AssetDownloadUrlResponse, err_ error)

Short-TTL presigned GET. Returns the metadata needed to write the file without a second round-trip. Gated on the holding memory's read access and on scanStatus — a PENDING or BLOCKED asset is refused with a typed error.

func (*AssetDownloadUrlResponse) GetAssetDownloadUrl added in v0.9.0 

func (v *AssetDownloadUrlResponse) GetAssetDownloadUrl() *AssetDownloadUrlAssetDownloadUrl

GetAssetDownloadUrl returns AssetDownloadUrlResponse.AssetDownloadUrl, and is useful for accessing the field via an interface.

type AssetScanStatus added in v0.9.0 

type AssetScanStatus string
const (
	AssetScanStatusBlocked AssetScanStatus = "BLOCKED"
	AssetScanStatusClean   AssetScanStatus = "CLEAN"
	AssetScanStatusPending AssetScanStatus = "PENDING"
)

type AttachMemoryToAppAttachMemoryToAppMemory added in v0.7.0 

type AttachMemoryToAppAttachMemoryToAppMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

AttachMemoryToAppAttachMemoryToAppMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetClass added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetClass() MemoryClass

GetClass returns AttachMemoryToAppAttachMemoryToAppMemory.Class, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetId added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetId() string

GetId returns AttachMemoryToAppAttachMemoryToAppMemory.Id, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetIsEncrypted added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetIsEncrypted() bool

GetIsEncrypted returns AttachMemoryToAppAttachMemoryToAppMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetMaxRevCount added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetMaxRevCount() int

GetMaxRevCount returns AttachMemoryToAppAttachMemoryToAppMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetName added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetName() string

GetName returns AttachMemoryToAppAttachMemoryToAppMemory.Name, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetOrganizationId added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetOrganizationId() *string

GetOrganizationId returns AttachMemoryToAppAttachMemoryToAppMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetShortDescription added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetShortDescription() *string

GetShortDescription returns AttachMemoryToAppAttachMemoryToAppMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetUpdatedAt added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetUpdatedAt() string

GetUpdatedAt returns AttachMemoryToAppAttachMemoryToAppMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetUrn added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetUrn() string

GetUrn returns AttachMemoryToAppAttachMemoryToAppMemory.Urn, and is useful for accessing the field via an interface.

func (*AttachMemoryToAppAttachMemoryToAppMemory) GetVisibility added in v0.7.0 

func (v *AttachMemoryToAppAttachMemoryToAppMemory) GetVisibility() *MemoryVisibility

GetVisibility returns AttachMemoryToAppAttachMemoryToAppMemory.Visibility, and is useful for accessing the field via an interface.

type AttachMemoryToAppResponse added in v0.7.0 

type AttachMemoryToAppResponse struct {
	// Attach an EXISTING free-standing memory to an App.
	//
	// Applies only to 'personal'/'private' memories owned by the caller (an
	// 'app'-class memory can't be free-standing, so there is nothing to attach).
	// Sets the App and Agent scope; the memory's URN, class, and owner are
	// unchanged. memoryRef/appRef/agentRef accept an ID, bare URN, or prefixed
	// URN; the Agent must be installed in the App. Requires App membership.
	//
	// Typed errors: UNSUPPORTED_MEMORY_CLASS, MEMORY_ALREADY_APP_SCOPED,
	// APP_UNINSTALLED, AGENT_NOT_INSTALLED, FORBIDDEN, ORGANIZATION_MISMATCH.
	AttachMemoryToApp *AttachMemoryToAppAttachMemoryToAppMemory `json:"attachMemoryToApp"`
}

AttachMemoryToAppResponse is returned by AttachMemoryToApp on success.

func AttachMemoryToApp added in v0.7.0 

func AttachMemoryToApp(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	appRef string,
	agentRef string,
) (data_ *AttachMemoryToAppResponse, err_ error)

Bind an existing free-standing personal/private memory to an App. All refs accept either IDs or URNs and are resolved by the server.

func (*AttachMemoryToAppResponse) GetAttachMemoryToApp added in v0.7.0 

func (v *AttachMemoryToAppResponse) GetAttachMemoryToApp() *AttachMemoryToAppAttachMemoryToAppMemory

GetAttachMemoryToApp returns AttachMemoryToAppResponse.AttachMemoryToApp, and is useful for accessing the field via an interface.

type AuthContextAuthContext added in v0.7.0 

type AuthContextAuthContext struct {
	// Which kind of credential authenticated this request.
	PrincipalType PrincipalType `json:"principalType"`
	// App.id — populated for APP principals (hdr_app_ key).
	AppId *string `json:"appId"`
	// Reserved for a future agent-credential principal; always null today.
	AgentId *string `json:"agentId"`
	// The authenticated User — populated for USER principals (JWT or
	// hdr_user_ key), null for App keys.
	User *AuthContextAuthContextUser `json:"user"`
	// The specific UserApiKey presented — populated only when the request
	// authenticated via an hdr_user_ key (its id, label, keyPreview,
	// createdAt, lastUsedAt, revokedAt). Null for JWT sessions and App keys.
	ApiKey *AuthContextAuthContextApiKeyUserApiKey `json:"apiKey"`
	// Set when the credential is an impersonation token: this request runs
	// READ-ONLY as the target user, scoped to one org. Null for every other
	// credential. Portal and CLI read this to render the acting-as state.
	Impersonation *AuthContextAuthContextImpersonationImpersonationInfo `json:"impersonation"`
}

AuthContextAuthContext includes the requested fields of the GraphQL type AuthContext. The GraphQL type's documentation follows.

The resolved principal for the credential presented on THIS request (issue #562). Exposes the AuthContext the server already resolves per request (cor:aut:020:02) read-only, so any surface (CLI, portal) can validate a token and name the exact credential without per-client hacks.

Security posture (held deliberately): - Current-request only. There is intentionally no query that takes an arbitrary token as an argument — that would be a token oracle. The caller must possess the credential, exactly as today. - No reason-leak. A credential that does not resolve yields a null authContext (Query field), identically for revoked / never-existed / malformed. Once a credential HAS resolved (you authenticated as it), surfacing active-vs-revoked via apiKey.revokedAt is fine.

func (*AuthContextAuthContext) GetAgentId added in v0.7.0 

func (v *AuthContextAuthContext) GetAgentId() *string

GetAgentId returns AuthContextAuthContext.AgentId, and is useful for accessing the field via an interface.

func (*AuthContextAuthContext) GetApiKey added in v0.7.0 

func (v *AuthContextAuthContext) GetApiKey() *AuthContextAuthContextApiKeyUserApiKey

GetApiKey returns AuthContextAuthContext.ApiKey, and is useful for accessing the field via an interface.

func (*AuthContextAuthContext) GetAppId added in v0.7.0 

func (v *AuthContextAuthContext) GetAppId() *string

GetAppId returns AuthContextAuthContext.AppId, and is useful for accessing the field via an interface.

func (*AuthContextAuthContext) GetImpersonation added in v0.9.0 

func (v *AuthContextAuthContext) GetImpersonation() *AuthContextAuthContextImpersonationImpersonationInfo

GetImpersonation returns AuthContextAuthContext.Impersonation, and is useful for accessing the field via an interface.

func (*AuthContextAuthContext) GetPrincipalType added in v0.7.0 

func (v *AuthContextAuthContext) GetPrincipalType() PrincipalType

GetPrincipalType returns AuthContextAuthContext.PrincipalType, and is useful for accessing the field via an interface.

func (*AuthContextAuthContext) GetUser added in v0.7.0 

func (v *AuthContextAuthContext) GetUser() *AuthContextAuthContextUser

GetUser returns AuthContextAuthContext.User, and is useful for accessing the field via an interface.

type AuthContextAuthContextApiKeyUserApiKey added in v0.7.0 

type AuthContextAuthContextApiKeyUserApiKey struct {
	UserApiKeyFields `json:"-"`
}

AuthContextAuthContextApiKeyUserApiKey includes the requested fields of the GraphQL type UserApiKey. The GraphQL type's documentation follows.

025-oauth-for-mcp: user-scoped bearer-token credential. Mirrors the AppKey shape but resolves to a User instead of an App. Surfaced to the portal revocation UI (Phase 3) so users can audit + revoke their own keys. userId is intentionally absent — for self-service v1 the caller is always the owner; admin-tooling auditability is out of scope (see contracts/graphql-mutations.md, PR-137 delta D1).

func (*AuthContextAuthContextApiKeyUserApiKey) GetCreatedAt added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) GetCreatedAt() string

GetCreatedAt returns AuthContextAuthContextApiKeyUserApiKey.CreatedAt, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextApiKeyUserApiKey) GetId added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) GetId() string

GetId returns AuthContextAuthContextApiKeyUserApiKey.Id, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextApiKeyUserApiKey) GetIssuedVia added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) GetIssuedVia() *string

GetIssuedVia returns AuthContextAuthContextApiKeyUserApiKey.IssuedVia, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextApiKeyUserApiKey) GetKeyPreview added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) GetKeyPreview() string

GetKeyPreview returns AuthContextAuthContextApiKeyUserApiKey.KeyPreview, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextApiKeyUserApiKey) GetLabel added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) GetLabel() *string

GetLabel returns AuthContextAuthContextApiKeyUserApiKey.Label, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextApiKeyUserApiKey) GetLastUsedAt added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) GetLastUsedAt() *string

GetLastUsedAt returns AuthContextAuthContextApiKeyUserApiKey.LastUsedAt, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextApiKeyUserApiKey) GetRevokedAt added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) GetRevokedAt() *string

GetRevokedAt returns AuthContextAuthContextApiKeyUserApiKey.RevokedAt, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextApiKeyUserApiKey) MarshalJSON added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) MarshalJSON() ([]byte, error)

func (*AuthContextAuthContextApiKeyUserApiKey) UnmarshalJSON added in v0.7.0 

func (v *AuthContextAuthContextApiKeyUserApiKey) UnmarshalJSON(b []byte) error

type AuthContextAuthContextImpersonationImpersonationInfo added in v0.9.0 

type AuthContextAuthContextImpersonationImpersonationInfo struct {
	SessionId      string `json:"sessionId"`
	OrganizationId string `json:"organizationId"`
	ExpiresAt      string `json:"expiresAt"`
	// Always true in v1 — impersonated sessions cannot mutate.
	ReadOnly bool `json:"readOnly"`
	// The admin behind the curtain (visibility per the normal User field
	// rules — the actor is a co-member of the scope org).
	ActorUser *AuthContextAuthContextImpersonationImpersonationInfoActorUser `json:"actorUser"`
}

AuthContextAuthContextImpersonationImpersonationInfo includes the requested fields of the GraphQL type ImpersonationInfo. The GraphQL type's documentation follows.

Admin impersonation (read-only support sessions): the acting-as facts of THIS request's credential, surfaced on AuthContext so whoami-style consumers can name the real actor, the scope org, and the expiry.

func (*AuthContextAuthContextImpersonationImpersonationInfo) GetActorUser added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfo) GetActorUser() *AuthContextAuthContextImpersonationImpersonationInfoActorUser

GetActorUser returns AuthContextAuthContextImpersonationImpersonationInfo.ActorUser, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextImpersonationImpersonationInfo) GetExpiresAt added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfo) GetExpiresAt() string

GetExpiresAt returns AuthContextAuthContextImpersonationImpersonationInfo.ExpiresAt, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextImpersonationImpersonationInfo) GetOrganizationId added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfo) GetOrganizationId() string

GetOrganizationId returns AuthContextAuthContextImpersonationImpersonationInfo.OrganizationId, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextImpersonationImpersonationInfo) GetReadOnly added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfo) GetReadOnly() bool

GetReadOnly returns AuthContextAuthContextImpersonationImpersonationInfo.ReadOnly, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextImpersonationImpersonationInfo) GetSessionId added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfo) GetSessionId() string

GetSessionId returns AuthContextAuthContextImpersonationImpersonationInfo.SessionId, and is useful for accessing the field via an interface.

type AuthContextAuthContextImpersonationImpersonationInfoActorUser added in v0.9.0 

type AuthContextAuthContextImpersonationImpersonationInfoActorUser struct {
	Id     string  `json:"id"`
	Handle *string `json:"handle"`
	Name   *string `json:"name"`
}

AuthContextAuthContextImpersonationImpersonationInfoActorUser includes the requested fields of the GraphQL type User.

func (*AuthContextAuthContextImpersonationImpersonationInfoActorUser) GetHandle added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfoActorUser) GetHandle() *string

GetHandle returns AuthContextAuthContextImpersonationImpersonationInfoActorUser.Handle, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextImpersonationImpersonationInfoActorUser) GetId added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfoActorUser) GetId() string

GetId returns AuthContextAuthContextImpersonationImpersonationInfoActorUser.Id, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextImpersonationImpersonationInfoActorUser) GetName added in v0.9.0 

func (v *AuthContextAuthContextImpersonationImpersonationInfoActorUser) GetName() *string

GetName returns AuthContextAuthContextImpersonationImpersonationInfoActorUser.Name, and is useful for accessing the field via an interface.

type AuthContextAuthContextUser added in v0.7.0 

type AuthContextAuthContextUser struct {
	Id             string  `json:"id"`
	Name           *string `json:"name"`
	Email          *string `json:"email"`
	Handle         *string `json:"handle"`
	GithubUsername *string `json:"githubUsername"`
	// Platform roles; an empty list is returned to viewers without personal-field access.
	Roles []Role `json:"roles"`
}

AuthContextAuthContextUser includes the requested fields of the GraphQL type User.

func (*AuthContextAuthContextUser) GetEmail added in v0.7.0 

func (v *AuthContextAuthContextUser) GetEmail() *string

GetEmail returns AuthContextAuthContextUser.Email, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextUser) GetGithubUsername added in v0.7.0 

func (v *AuthContextAuthContextUser) GetGithubUsername() *string

GetGithubUsername returns AuthContextAuthContextUser.GithubUsername, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextUser) GetHandle added in v0.7.0 

func (v *AuthContextAuthContextUser) GetHandle() *string

GetHandle returns AuthContextAuthContextUser.Handle, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextUser) GetId added in v0.7.0 

func (v *AuthContextAuthContextUser) GetId() string

GetId returns AuthContextAuthContextUser.Id, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextUser) GetName added in v0.7.0 

func (v *AuthContextAuthContextUser) GetName() *string

GetName returns AuthContextAuthContextUser.Name, and is useful for accessing the field via an interface.

func (*AuthContextAuthContextUser) GetRoles added in v0.7.0 

func (v *AuthContextAuthContextUser) GetRoles() []Role

GetRoles returns AuthContextAuthContextUser.Roles, and is useful for accessing the field via an interface.

type AuthContextResponse added in v0.7.0 

type AuthContextResponse struct {
	// The resolved principal for the credential on THIS request (issue #562).
	// Credential-type-agnostic: works for personal API keys, JWT sessions, and
	// App keys alike — unlike me, which is null for a valid App credential.
	// Returns null when the presented credential does not resolve (identically
	// for revoked / never-existed / malformed — never a token oracle). See the
	// AuthContext type for the full security posture.
	AuthContext *AuthContextAuthContext `json:"authContext"`
}

AuthContextResponse is returned by AuthContext on success.

func AuthContext added in v0.7.0 

func AuthContext(
	ctx_ context.Context,
	client_ graphql.Client,
) (data_ *AuthContextResponse, err_ error)

The resolved principal for the credential on THIS request (server #562). Credential-type-agnostic — unlike `me`, it's populated for a valid App key too, and (for a user key) names the exact UserApiKey presented. Null when the credential doesn't resolve (revoked / unknown / malformed alike — no oracle).

func (*AuthContextResponse) GetAuthContext added in v0.7.0 

func (v *AuthContextResponse) GetAuthContext() *AuthContextAuthContext

GetAuthContext returns AuthContextResponse.AuthContext, and is useful for accessing the field via an interface.

type BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult added in v0.9.0 

type BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult struct {
	UploadId        string                                                                              `json:"uploadId"`
	PutUrl          string                                                                              `json:"putUrl"`
	PutHeaders      []*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader `json:"putHeaders"`
	StorageKey      string                                                                              `json:"storageKey"`
	MaxSizeBytes    int                                                                                 `json:"maxSizeBytes"`
	AllowedMimeType string                                                                              `json:"allowedMimeType"`
	ExpiresAt       string                                                                              `json:"expiresAt"`
}

BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult includes the requested fields of the GraphQL type BeginAssetUploadResult.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetAllowedMimeType added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetAllowedMimeType() string

GetAllowedMimeType returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult.AllowedMimeType, and is useful for accessing the field via an interface.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetExpiresAt added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetExpiresAt() string

GetExpiresAt returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult.ExpiresAt, and is useful for accessing the field via an interface.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetMaxSizeBytes added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetMaxSizeBytes() int

GetMaxSizeBytes returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult.MaxSizeBytes, and is useful for accessing the field via an interface.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetPutHeaders added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetPutHeaders() []*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader

GetPutHeaders returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult.PutHeaders, and is useful for accessing the field via an interface.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetPutUrl added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetPutUrl() string

GetPutUrl returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult.PutUrl, and is useful for accessing the field via an interface.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetStorageKey added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetStorageKey() string

GetStorageKey returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult.StorageKey, and is useful for accessing the field via an interface.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetUploadId added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult) GetUploadId() string

GetUploadId returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult.UploadId, and is useful for accessing the field via an interface.

type BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader added in v0.9.0 

type BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader includes the requested fields of the GraphQL type AssetPutHeader.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader) GetName added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader) GetName() string

GetName returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader.Name, and is useful for accessing the field via an interface.

func (*BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader) GetValue added in v0.9.0 

func (v *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader) GetValue() string

GetValue returns BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResultPutHeadersAssetPutHeader.Value, and is useful for accessing the field via an interface.

type BeginAssetUploadResponse added in v0.9.0 

type BeginAssetUploadResponse struct {
	// Asset upload — v2 (spec 006-asset-upload-redesign)
	// Memory-addressed begin: the caller specifies the destination
	// memory directly, no agent traversal. Replaces agent-addressed
	// beginAssetUpload during the deprecation window.
	BeginAssetUploadV2 *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult `json:"beginAssetUploadV2"`
}

BeginAssetUploadResponse is returned by BeginAssetUpload on success.

func BeginAssetUpload added in v0.9.0 

func BeginAssetUpload(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryId string,
	filename string,
	mimeType string,
	sizeBytes int,
	intent UploadIntent,
	description *string,
) (data_ *BeginAssetUploadResponse, err_ error)

Step 1 of 3. The server reserves the asset row and hands back a presigned PUT plus the exact headers to send with it — sizeBytes and mimeType are declared up front so the size cap and MIME allowlist are enforced BEFORE any bytes move, and the typed rejection comes back here rather than from storage.

uploadRequestId is omitted for a CLI-initiated upload; it belongs to the agent-request flow (an agent asking a user for a file).

func (*BeginAssetUploadResponse) GetBeginAssetUploadV2 added in v0.9.0 

func (v *BeginAssetUploadResponse) GetBeginAssetUploadV2() *BeginAssetUploadBeginAssetUploadV2BeginAssetUploadResult

GetBeginAssetUploadV2 returns BeginAssetUploadResponse.BeginAssetUploadV2, and is useful for accessing the field via an interface.

type CancelAppRunCancelAppRun added in v0.6.0 

type CancelAppRunCancelAppRun struct {
	AppRunFields `json:"-"`
}

CancelAppRunCancelAppRun includes the requested fields of the GraphQL type AppRun. The GraphQL type's documentation follows.

One headless run — the audit record AND (v1) the activation: policy snapshot, live budgets (zeroing halts the run), lifecycle, trigger provenance. Spec cor:agt:010:02.

func (*CancelAppRunCancelAppRun) GetAgentId added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetAgentId() *string

GetAgentId returns CancelAppRunCancelAppRun.AgentId, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetAppId added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetAppId() string

GetAppId returns CancelAppRunCancelAppRun.AppId, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetAttempts added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetAttempts() int

GetAttempts returns CancelAppRunCancelAppRun.Attempts, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetBudgetActions added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetBudgetActions() *int

GetBudgetActions returns CancelAppRunCancelAppRun.BudgetActions, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetBudgetTokens added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetBudgetTokens() *int

GetBudgetTokens returns CancelAppRunCancelAppRun.BudgetTokens, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetCreatedAt added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetCreatedAt() string

GetCreatedAt returns CancelAppRunCancelAppRun.CreatedAt, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetCreatedBy added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetCreatedBy() *string

GetCreatedBy returns CancelAppRunCancelAppRun.CreatedBy, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetCurNodeUrn added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetCurNodeUrn() *string

GetCurNodeUrn returns CancelAppRunCancelAppRun.CurNodeUrn, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetData added in v0.7.0 

func (v *CancelAppRunCancelAppRun) GetData() *json.RawMessage

GetData returns CancelAppRunCancelAppRun.Data, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetEntryNodeUrn added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetEntryNodeUrn() string

GetEntryNodeUrn returns CancelAppRunCancelAppRun.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetEventData added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetEventData() *json.RawMessage

GetEventData returns CancelAppRunCancelAppRun.EventData, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetFailure added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetFailure() *json.RawMessage

GetFailure returns CancelAppRunCancelAppRun.Failure, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetFinishedAt added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetFinishedAt() *string

GetFinishedAt returns CancelAppRunCancelAppRun.FinishedAt, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetId added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetId() string

GetId returns CancelAppRunCancelAppRun.Id, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetOrganizationId added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetOrganizationId() string

GetOrganizationId returns CancelAppRunCancelAppRun.OrganizationId, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetParentRunId added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetParentRunId() *string

GetParentRunId returns CancelAppRunCancelAppRun.ParentRunId, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetPolicy added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetPolicy() *json.RawMessage

GetPolicy returns CancelAppRunCancelAppRun.Policy, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetStartedAt added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetStartedAt() *string

GetStartedAt returns CancelAppRunCancelAppRun.StartedAt, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetStatus added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetStatus() AppRunStatus

GetStatus returns CancelAppRunCancelAppRun.Status, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetTimeoutMs added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetTimeoutMs() *int

GetTimeoutMs returns CancelAppRunCancelAppRun.TimeoutMs, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetTriggerId added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetTriggerId() *string

GetTriggerId returns CancelAppRunCancelAppRun.TriggerId, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetTriggerKind added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetTriggerKind() AppRunTriggerKind

GetTriggerKind returns CancelAppRunCancelAppRun.TriggerKind, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) GetUserId added in v0.6.0 

func (v *CancelAppRunCancelAppRun) GetUserId() *string

GetUserId returns CancelAppRunCancelAppRun.UserId, and is useful for accessing the field via an interface.

func (*CancelAppRunCancelAppRun) MarshalJSON added in v0.6.0 

func (v *CancelAppRunCancelAppRun) MarshalJSON() ([]byte, error)

func (*CancelAppRunCancelAppRun) UnmarshalJSON added in v0.6.0 

func (v *CancelAppRunCancelAppRun) UnmarshalJSON(b []byte) error

type CancelAppRunResponse added in v0.6.0 

type CancelAppRunResponse struct {
	// The kill switch manual handle: PENDING/RUNNING to CANCELLED (cor:agt:010:02).
	CancelAppRun *CancelAppRunCancelAppRun `json:"cancelAppRun"`
}

CancelAppRunResponse is returned by CancelAppRun on success.

func CancelAppRun added in v0.6.0 

func CancelAppRun(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *CancelAppRunResponse, err_ error)

The kill switch — transitions a live run to CANCELLED.

func (*CancelAppRunResponse) GetCancelAppRun added in v0.6.0 

func (v *CancelAppRunResponse) GetCancelAppRun() *CancelAppRunCancelAppRun

GetCancelAppRun returns CancelAppRunResponse.CancelAppRun, and is useful for accessing the field via an interface.

type CastWorkerCastWorker added in v0.9.0 

type CastWorkerCastWorker struct {
	WorkerFields `json:"-"`
}

CastWorkerCastWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*CastWorkerCastWorker) GetAgentId added in v0.9.0 

func (v *CastWorkerCastWorker) GetAgentId() string

GetAgentId returns CastWorkerCastWorker.AgentId, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetAppId added in v0.9.0 

func (v *CastWorkerCastWorker) GetAppId() string

GetAppId returns CastWorkerCastWorker.AppId, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetCreatedAt added in v0.9.0 

func (v *CastWorkerCastWorker) GetCreatedAt() string

GetCreatedAt returns CastWorkerCastWorker.CreatedAt, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetCreatedBy added in v0.9.0 

func (v *CastWorkerCastWorker) GetCreatedBy() *string

GetCreatedBy returns CastWorkerCastWorker.CreatedBy, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetHasLiveSession added in v0.13.0 

func (v *CastWorkerCastWorker) GetHasLiveSession() *bool

GetHasLiveSession returns CastWorkerCastWorker.HasLiveSession, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetHeldAt added in v0.10.0 

func (v *CastWorkerCastWorker) GetHeldAt() *string

GetHeldAt returns CastWorkerCastWorker.HeldAt, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetHeldByUserId added in v0.10.0 

func (v *CastWorkerCastWorker) GetHeldByUserId() *string

GetHeldByUserId returns CastWorkerCastWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetId added in v0.9.0 

func (v *CastWorkerCastWorker) GetId() string

GetId returns CastWorkerCastWorker.Id, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetLastActiveAt added in v0.13.0 

func (v *CastWorkerCastWorker) GetLastActiveAt() *string

GetLastActiveAt returns CastWorkerCastWorker.LastActiveAt, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetMemoryId added in v0.9.0 

func (v *CastWorkerCastWorker) GetMemoryId() *string

GetMemoryId returns CastWorkerCastWorker.MemoryId, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetName added in v0.9.0 

func (v *CastWorkerCastWorker) GetName() string

GetName returns CastWorkerCastWorker.Name, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetPortalUrl added in v0.12.0 

func (v *CastWorkerCastWorker) GetPortalUrl() *string

GetPortalUrl returns CastWorkerCastWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetPrompt added in v0.9.0 

func (v *CastWorkerCastWorker) GetPrompt() *string

GetPrompt returns CastWorkerCastWorker.Prompt, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetPromptOverride added in v0.9.0 

func (v *CastWorkerCastWorker) GetPromptOverride() *string

GetPromptOverride returns CastWorkerCastWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetRepos added in v0.12.0 

func (v *CastWorkerCastWorker) GetRepos() []string

GetRepos returns CastWorkerCastWorker.Repos, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetRetiredAt added in v0.9.0 

func (v *CastWorkerCastWorker) GetRetiredAt() *string

GetRetiredAt returns CastWorkerCastWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetRetiredBy added in v0.9.0 

func (v *CastWorkerCastWorker) GetRetiredBy() *string

GetRetiredBy returns CastWorkerCastWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetRole added in v0.9.0 

func (v *CastWorkerCastWorker) GetRole() *string

GetRole returns CastWorkerCastWorker.Role, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetSlug added in v0.10.0 

func (v *CastWorkerCastWorker) GetSlug() string

GetSlug returns CastWorkerCastWorker.Slug, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) GetUrn added in v0.10.0 

func (v *CastWorkerCastWorker) GetUrn() *string

GetUrn returns CastWorkerCastWorker.Urn, and is useful for accessing the field via an interface.

func (*CastWorkerCastWorker) MarshalJSON added in v0.9.0 

func (v *CastWorkerCastWorker) MarshalJSON() ([]byte, error)

func (*CastWorkerCastWorker) UnmarshalJSON added in v0.9.0 

func (v *CastWorkerCastWorker) UnmarshalJSON(b []byte) error

type CastWorkerPreviewCastWorkerPreview added in v0.9.0 

type CastWorkerPreviewCastWorkerPreview struct {
	// The name the cast would take — the caller's, checked free against the App's FULL roster (retired names stay taken). Required since #1050; a nameless preview refuses exactly where the cast would.
	Name string `json:"name"`
	// The casting's role: explicit, else the agent's personaRole dressing.
	Role *string `json:"role"`
	// The role-agent the casting would bind.
	AgentId   string `json:"agentId"`
	AgentName string `json:"agentName"`
	// The composed boot prompt, post {{name}}/{{role}} substitution with
	// promptOverride appended — the same composition Worker.prompt performs,
	// reviewable BEFORE the name is permanent. Null when the agent carries no
	// template and no override was given.
	Prompt *string `json:"prompt"`
	// Whether the agent's systemPrompt binds {{name}} — a nameless template silently produces workers whose prompt never names them. Null when the agent has no template.
	HasNamePlaceholder *bool `json:"hasNamePlaceholder"`
}

CastWorkerPreviewCastWorkerPreview includes the requested fields of the GraphQL type CastWorkerPreview. The GraphQL type's documentation follows.

What castWorker WOULD do (#964) — an unsaved projection, deliberately not a Worker (no fake id to mistake for a real row). Scalars only: the ids/names here are attribution-level facts the mint-gate audience already sees, so no nested entity hands out its field resolvers.

func (*CastWorkerPreviewCastWorkerPreview) GetAgentId added in v0.9.0 

func (v *CastWorkerPreviewCastWorkerPreview) GetAgentId() string

GetAgentId returns CastWorkerPreviewCastWorkerPreview.AgentId, and is useful for accessing the field via an interface.

func (*CastWorkerPreviewCastWorkerPreview) GetAgentName added in v0.9.0 

func (v *CastWorkerPreviewCastWorkerPreview) GetAgentName() string

GetAgentName returns CastWorkerPreviewCastWorkerPreview.AgentName, and is useful for accessing the field via an interface.

func (*CastWorkerPreviewCastWorkerPreview) GetHasNamePlaceholder added in v0.9.0 

func (v *CastWorkerPreviewCastWorkerPreview) GetHasNamePlaceholder() *bool

GetHasNamePlaceholder returns CastWorkerPreviewCastWorkerPreview.HasNamePlaceholder, and is useful for accessing the field via an interface.

func (*CastWorkerPreviewCastWorkerPreview) GetName added in v0.9.0 

func (v *CastWorkerPreviewCastWorkerPreview) GetName() string

GetName returns CastWorkerPreviewCastWorkerPreview.Name, and is useful for accessing the field via an interface.

func (*CastWorkerPreviewCastWorkerPreview) GetPrompt added in v0.9.0 

func (v *CastWorkerPreviewCastWorkerPreview) GetPrompt() *string

GetPrompt returns CastWorkerPreviewCastWorkerPreview.Prompt, and is useful for accessing the field via an interface.

func (*CastWorkerPreviewCastWorkerPreview) GetRole added in v0.9.0 

func (v *CastWorkerPreviewCastWorkerPreview) GetRole() *string

GetRole returns CastWorkerPreviewCastWorkerPreview.Role, and is useful for accessing the field via an interface.

type CastWorkerPreviewResponse added in v0.9.0 

type CastWorkerPreviewResponse struct {
	// Dry-run castWorker (#964): run the cast's exact resolution — same
	// arguments, same typed refusals (WORKER_AGENT_NOT_FOUND / _AMBIGUOUS /
	// _NOT_INSTALLED, WORKER_NAME_REQUIRED, WORKER_NAME_TAKEN, APP_UNINSTALLED),
	// same MINT gate — up to but not
	// including the writes, and return what would be created. A Query, not a
	// dryRun flag: casting a name is the one irreversible act in the team
	// feature (cor:agt:020:02 — permanence), and previewing it must not need a
	// mutation permission model or a fake Worker row. THE PREVIEW RESERVES
	// NOTHING: no lease exists by law (cor:agt:020:03), so a previewed name may
	// be gone at cast time — by design; the cast's uniqueness constraint
	// remains the only allocation primitive.
	CastWorkerPreview *CastWorkerPreviewCastWorkerPreview `json:"castWorkerPreview"`
}

CastWorkerPreviewResponse is returned by CastWorkerPreview on success.

func CastWorkerPreview added in v0.9.0 

func CastWorkerPreview(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	agentRef *string,
	role *string,
	name *string,
	promptOverride *string,
) (data_ *CastWorkerPreviewResponse, err_ error)

── Cast preview (#404 / hadron-server#964) — dry-run the irreversible cast. A QUERY, deliberately: previewing must not need mutation permissions or a fake Worker row. It runs the cast's exact resolution — same arguments, same typed refusals, same mint gate — up to but not including the writes. THE PREVIEW RESERVES NOTHING (no lease by law, cor:agt:020:03): a previewed name may be gone at cast time; the cast's uniqueness constraint stays the only allocation primitive.

func (*CastWorkerPreviewResponse) GetCastWorkerPreview added in v0.9.0 

func (v *CastWorkerPreviewResponse) GetCastWorkerPreview() *CastWorkerPreviewCastWorkerPreview

GetCastWorkerPreview returns CastWorkerPreviewResponse.CastWorkerPreview, and is useful for accessing the field via an interface.

type CastWorkerResponse added in v0.9.0 

type CastWorkerResponse struct {
	// #974 — cast a Worker (cor:dmo:050:11, cor:agt:020:01/:02): the named
	// casting of an agent ALREADY INSTALLED in the App, superseding
	// createTeamPersona's minting semantics (nothing is minted — the agent
	// carries the persona dressing; the Worker is the local named identity).
	// Casting is opt-in, never requires a Team Agent (an explicit name skips the
	// register entirely), and multiple castings of one agent per App are legal
	// (Iris and Henry, both backend-engineer).
	//
	// Agent resolution: agentRef when given (must be installed here —
	// WORKER_AGENT_NOT_INSTALLED); otherwise role picks the single installed
	// agent whose personaRole matches (zero / several candidates:
	// WORKER_AGENT_NOT_FOUND / WORKER_AGENT_AMBIGUOUS, never a guess). The
	// casting's role defaults to the agent's personaRole when role is omitted.
	//
	// The name (cor:agt:020:02) is REQUIRED since #1050 — one attempt, and
	// WORKER_NAME_TAKEN is the answer. There is no register to fall back to: a
	// name is permanent within the App, so it is chosen and never derived, and a
	// nameless cast refuses WORKER_NAME_REQUIRED rather than minting a permanent
	// identifier nobody picked. The workers_app_name_uniq constraint IS the
	// arbiter. Names are unique per App, case-insensitively, FOREVER (two Apps
	// may each have an Iris; retirement and uninstall never free a name).
	//
	// A worker-scoped working memory is provisioned in the App's container
	// (Worker.memoryId; best-effort — a failed provision leaves it null for
	// lazy provisioning).
	//
	// Authorization: an org member with CONTRIBUTOR+ on the App's org, an
	// AppMember of the App whose role is not 'reader', or the owner of a
	// user-owned App. Pure App-key principals are denied.
	//
	// Error codes (extensions.code): WORKER_NAME_TAKEN,
	// WORKER_NAME_REQUIRED, WORKER_AGENT_NOT_INSTALLED,
	// WORKER_AGENT_NOT_FOUND, WORKER_AGENT_AMBIGUOUS, APP_UNINSTALLED.
	//
	// #1050 also removed WORKER_ROLE_NOT_FOUND from this mutation: it fired only
	// because a nameless cast had to find a roles:<role> node to read a register.
	// An unrecognized role now resolves no agent (WORKER_AGENT_NOT_FOUND) or, with
	// an explicit agentRef, is simply the casting's label.
	//
	// #1050: the TEAM_AGENT_* and SESSION_EXPIRED refusals are gone from this
	// mutation. They were reachable only because a nameless cast had to locate a
	// Team Agent and read its (possibly encrypted) system memory to find a
	// register. Casting now touches no system memory at all, so teamAgentRef is
	// gone too rather than left accepted-and-ignored.
	//
	// Accepts the entity's ID or URN for appRef and agentRef.
	CastWorker *CastWorkerCastWorker `json:"castWorker"`
}

CastWorkerResponse is returned by CastWorker on success.

func CastWorker added in v0.9.0 

func CastWorker(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	agentRef *string,
	role *string,
	name *string,
	promptOverride *string,
) (data_ *CastWorkerResponse, err_ error)

Casting is ONE platform call (cor:agt:020:01/:02): the server resolves the agent (agentRef, or role → the single installed agent whose personaRole matches — WORKER_AGENT_NOT_FOUND / _AMBIGUOUS, never a guess), takes the name, composes Worker.prompt, and provisions the worker-scoped memory. The CLI passes values through and retries nothing.

The NAME IS REQUIRED (hadron-server#1050): there is no register to walk, and a name is permanent within the App (cor:agt:020:02), so it is chosen and never derived — the server will not invent a permanent identifier nobody picked. A cast without one refuses WORKER_NAME_REQUIRED.

teamAgentRef is gone from both operations too: casting no longer reads any system memory, so it had become accepted-and-ignored.

func (*CastWorkerResponse) GetCastWorker added in v0.9.0 

func (v *CastWorkerResponse) GetCastWorker() *CastWorkerCastWorker

GetCastWorker returns CastWorkerResponse.CastWorker, and is useful for accessing the field via an interface.

type ChannelFields added in v0.14.0 

type ChannelFields struct {
	Id          string      `json:"id"`
	Name        string      `json:"name"`
	Description *string     `json:"description"`
	Kind        ChannelKind `json:"kind"`
	// The reserved address of the chat root (e.g. chats:team).
	Loc string `json:"loc"`
	// Host memory.
	MemoryId string `json:"memoryId"`
	// #1171 — the Channel's ADDRESS: its chat root's node URN
	// (hrn:node:<org>:<memory>:<loc>). A channelRef takes TWO FORMS — an id, or a
	// chat-root node ref — and the node ref is accepted in every spelling the
	// node resolver takes (`urn:node:`, bare fully-qualified, canonical `::`);
	// this field emits the one to copy. COPY it rather than composing one: a
	// Channel a ref fails to name is indistinguishable from one you may not read.
	//
	// NULL when the server has no flat-v2 address it can safely advertise —
	// commonly a pre-v2 compound host memory URN, which flattens into a node URN
	// that cannot be split back. It does NOT mean the Channel is unaddressable in
	// principle (a canonical `::` spelling can still resolve one); it means the
	// server will not hand you a string it would itself reject. Use `id` there;
	// it always works.
	ChatRootUrn *string `json:"chatRootUrn"`
	// The chat root node this Channel IS the entity for (one-to-one).
	ChatRootNodeId string `json:"chatRootNodeId"`
	// Highest seq the allocator has issued — a watermark, not a count.
	LastSeq       int     `json:"lastSeq"`
	LastMessageAt *string `json:"lastMessageAt"`
	CreatedAt     string  `json:"createdAt"`
	UpdatedAt     *string `json:"updatedAt"`
}

ChannelFields includes the GraphQL fields of Channel requested by the fragment ChannelFields. The GraphQL type's documentation follows.

A CHANNEL (spec 049, D-2026-09-13-006): a durable, ordered message stream hosted in ONE memory at ONE reserved address, server-ordered and server-attributed — a platform entity, created one-to-one with its chat root. Creating it RESERVES and PROTECTS the address: generic node writes under it are refused (LOC_PROTECTED); its own operations (createTeamChatMessage, hadron_team_chat_post) are the only writers. The audience is the host memory's (cor:acl:030:01) — a Channel has no access layer of its own. `lastSeq` / `lastMessageAt` are the platform-maintained watermark.

func (*ChannelFields) GetChatRootNodeId added in v0.14.0 

func (v *ChannelFields) GetChatRootNodeId() string

GetChatRootNodeId returns ChannelFields.ChatRootNodeId, and is useful for accessing the field via an interface.

func (*ChannelFields) GetChatRootUrn added in v0.14.0 

func (v *ChannelFields) GetChatRootUrn() *string

GetChatRootUrn returns ChannelFields.ChatRootUrn, and is useful for accessing the field via an interface.

func (*ChannelFields) GetCreatedAt added in v0.14.0 

func (v *ChannelFields) GetCreatedAt() string

GetCreatedAt returns ChannelFields.CreatedAt, and is useful for accessing the field via an interface.

func (*ChannelFields) GetDescription added in v0.14.0 

func (v *ChannelFields) GetDescription() *string

GetDescription returns ChannelFields.Description, and is useful for accessing the field via an interface.

func (*ChannelFields) GetId added in v0.14.0 

func (v *ChannelFields) GetId() string

GetId returns ChannelFields.Id, and is useful for accessing the field via an interface.

func (*ChannelFields) GetKind added in v0.14.0 

func (v *ChannelFields) GetKind() ChannelKind

GetKind returns ChannelFields.Kind, and is useful for accessing the field via an interface.

func (*ChannelFields) GetLastMessageAt added in v0.14.0 

func (v *ChannelFields) GetLastMessageAt() *string

GetLastMessageAt returns ChannelFields.LastMessageAt, and is useful for accessing the field via an interface.

func (*ChannelFields) GetLastSeq added in v0.14.0 

func (v *ChannelFields) GetLastSeq() int

GetLastSeq returns ChannelFields.LastSeq, and is useful for accessing the field via an interface.

func (*ChannelFields) GetLoc added in v0.14.0 

func (v *ChannelFields) GetLoc() string

GetLoc returns ChannelFields.Loc, and is useful for accessing the field via an interface.

func (*ChannelFields) GetMemoryId added in v0.14.0 

func (v *ChannelFields) GetMemoryId() string

GetMemoryId returns ChannelFields.MemoryId, and is useful for accessing the field via an interface.

func (*ChannelFields) GetName added in v0.14.0 

func (v *ChannelFields) GetName() string

GetName returns ChannelFields.Name, and is useful for accessing the field via an interface.

func (*ChannelFields) GetUpdatedAt added in v0.14.0 

func (v *ChannelFields) GetUpdatedAt() *string

GetUpdatedAt returns ChannelFields.UpdatedAt, and is useful for accessing the field via an interface.

type ChannelFilter added in v0.14.0 

type ChannelFilter struct {
	AppRef    *string `json:"appRef"`
	MemoryRef *string `json:"memoryRef"`
}

Filter for channels(): by App (its host memories' Channels) or by one host memory. Refs: ID or URN.

func (*ChannelFilter) GetAppRef added in v0.14.0 

func (v *ChannelFilter) GetAppRef() *string

GetAppRef returns ChannelFilter.AppRef, and is useful for accessing the field via an interface.

func (*ChannelFilter) GetMemoryRef added in v0.14.0 

func (v *ChannelFilter) GetMemoryRef() *string

GetMemoryRef returns ChannelFilter.MemoryRef, and is useful for accessing the field via an interface.

type ChannelKind added in v0.14.0 

type ChannelKind string

What kind of feed a Channel is. CHAT today; BLOCKERS / TASKS when built. 

const (
	ChannelKindChat ChannelKind = "CHAT"
)

type ChannelMemory added in v0.14.0 

type ChannelMemory struct {
	Memory *ChannelMemoryMemory `json:"memory"`
}

The host memory, projected separately so a listing can name where a Channel lives without a second read — two Channels named `team` at loc `chats:team` are distinguishable only by this.

func (*ChannelMemory) GetMemory added in v0.14.0 

func (v *ChannelMemory) GetMemory() *ChannelMemoryMemory

GetMemory returns ChannelMemory.Memory, and is useful for accessing the field via an interface.

type ChannelMemoryMemory added in v0.14.0 

type ChannelMemoryMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn  string `json:"urn"`
	Name string `json:"name"`
}

ChannelMemoryMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*ChannelMemoryMemory) GetId added in v0.14.0 

func (v *ChannelMemoryMemory) GetId() string

GetId returns ChannelMemoryMemory.Id, and is useful for accessing the field via an interface.

func (*ChannelMemoryMemory) GetName added in v0.14.0 

func (v *ChannelMemoryMemory) GetName() string

GetName returns ChannelMemoryMemory.Name, and is useful for accessing the field via an interface.

func (*ChannelMemoryMemory) GetUrn added in v0.14.0 

func (v *ChannelMemoryMemory) GetUrn() string

GetUrn returns ChannelMemoryMemory.Urn, and is useful for accessing the field via an interface.

type ChannelMessageFields added in v0.14.0 

type ChannelMessageFields struct {
	// Ordering key, unique per chat, allocated atomically (ascending from 1).
	Seq  int    `json:"seq"`
	At   string `json:"at"`
	Body string `json:"body"`
	// Display convenience: the worker name or the user handle.
	AuthorName     *string `json:"authorName"`
	AuthorWorkerId *string `json:"authorWorkerId"`
	AuthorUserId   *string `json:"authorUserId"`
	// Spec 049 Phase 8 (item J): the Worker's App when the post crossed Apps — visible as one in the transcript.
	AuthorAppId *string `json:"authorAppId"`
	// The session driving the worker author, when posted via sessionRef.
	SessionId *string `json:"sessionId"`
	// The seq this message replies to, when it is a reply.
	ReplyToSeq *int     `json:"replyToSeq"`
	Mentions   []string `json:"mentions"`
	// The message node's id.
	NodeId string `json:"nodeId"`
}

ChannelMessageFields includes the GraphQL fields of TeamChatMessage requested by the fragment ChannelMessageFields. The GraphQL type's documentation follows.

One message in a team App's chat (#939, Worker envelope since #974). Exactly one of authorUserId / authorWorkerId is set: a human post carries the user, a worker post carries the Worker (the named casting, cor:dmo:050:11) plus the driving sessionId. mentions holds the lowercased tokens extracted server-side at write time (the '@worker-name / @handle' format, stored without the '@').

func (*ChannelMessageFields) GetAt added in v0.14.0 

func (v *ChannelMessageFields) GetAt() string

GetAt returns ChannelMessageFields.At, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetAuthorAppId added in v0.14.0 

func (v *ChannelMessageFields) GetAuthorAppId() *string

GetAuthorAppId returns ChannelMessageFields.AuthorAppId, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetAuthorName added in v0.14.0 

func (v *ChannelMessageFields) GetAuthorName() *string

GetAuthorName returns ChannelMessageFields.AuthorName, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetAuthorUserId added in v0.14.0 

func (v *ChannelMessageFields) GetAuthorUserId() *string

GetAuthorUserId returns ChannelMessageFields.AuthorUserId, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetAuthorWorkerId added in v0.14.0 

func (v *ChannelMessageFields) GetAuthorWorkerId() *string

GetAuthorWorkerId returns ChannelMessageFields.AuthorWorkerId, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetBody added in v0.14.0 

func (v *ChannelMessageFields) GetBody() string

GetBody returns ChannelMessageFields.Body, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetMentions added in v0.14.0 

func (v *ChannelMessageFields) GetMentions() []string

GetMentions returns ChannelMessageFields.Mentions, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetNodeId added in v0.14.0 

func (v *ChannelMessageFields) GetNodeId() string

GetNodeId returns ChannelMessageFields.NodeId, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetReplyToSeq added in v0.14.0 

func (v *ChannelMessageFields) GetReplyToSeq() *int

GetReplyToSeq returns ChannelMessageFields.ReplyToSeq, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetSeq added in v0.14.0 

func (v *ChannelMessageFields) GetSeq() int

GetSeq returns ChannelMessageFields.Seq, and is useful for accessing the field via an interface.

func (*ChannelMessageFields) GetSessionId added in v0.14.0 

func (v *ChannelMessageFields) GetSessionId() *string

GetSessionId returns ChannelMessageFields.SessionId, and is useful for accessing the field via an interface.

type ChannelMessagesChannelMessagesTeamChatMessagesPage added in v0.14.0 

type ChannelMessagesChannelMessagesTeamChatMessagesPage struct {
	// Number of canonical messages matching this read's sinceSeq/beforeSeq cursor
	// range and mentionsRef filter, before limit/offset. It is not the total
	// number of messages in the chat or Channel when a cursor/filter is present.
	Total int                                                                       `json:"total"`
	Items []*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage `json:"items"`
}

ChannelMessagesChannelMessagesTeamChatMessagesPage includes the requested fields of the GraphQL type TeamChatMessagesPage.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPage) GetItems added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPage) GetItems() []*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage

GetItems returns ChannelMessagesChannelMessagesTeamChatMessagesPage.Items, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPage) GetTotal added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPage) GetTotal() int

GetTotal returns ChannelMessagesChannelMessagesTeamChatMessagesPage.Total, and is useful for accessing the field via an interface.

type ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage added in v0.14.0 

type ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage struct {
	ChannelMessageFields `json:"-"`
}

ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage includes the requested fields of the GraphQL type TeamChatMessage. The GraphQL type's documentation follows.

One message in a team App's chat (#939, Worker envelope since #974). Exactly one of authorUserId / authorWorkerId is set: a human post carries the user, a worker post carries the Worker (the named casting, cor:dmo:050:11) plus the driving sessionId. mentions holds the lowercased tokens extracted server-side at write time (the '@worker-name / @handle' format, stored without the '@').

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAt added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAt() string

GetAt returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.At, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorAppId added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorAppId() *string

GetAuthorAppId returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.AuthorAppId, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorName added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorName() *string

GetAuthorName returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.AuthorName, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorUserId added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorUserId() *string

GetAuthorUserId returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.AuthorUserId, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorWorkerId added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorWorkerId() *string

GetAuthorWorkerId returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.AuthorWorkerId, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetBody added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetBody() string

GetBody returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.Body, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetMentions added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetMentions() []string

GetMentions returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.Mentions, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetNodeId added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetNodeId() string

GetNodeId returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.NodeId, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetReplyToSeq added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetReplyToSeq() *int

GetReplyToSeq returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.ReplyToSeq, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSeq added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSeq() int

GetSeq returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.Seq, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSessionId added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSessionId() *string

GetSessionId returns ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage.SessionId, and is useful for accessing the field via an interface.

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) MarshalJSON added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) MarshalJSON() ([]byte, error)

func (*ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) UnmarshalJSON added in v0.14.0 

func (v *ChannelMessagesChannelMessagesTeamChatMessagesPageItemsTeamChatMessage) UnmarshalJSON(b []byte) error

type ChannelMessagesResponse added in v0.14.0 

type ChannelMessagesResponse struct {
	// Spec 049 Phase 8 — read ANY Channel by ref (its id, or its address —
	// `Channel.chatRootUrn`, #1171), with teamChatMessages'
	// cursors, mentions filter and paging; teamChatMessages is the
	// appRef → App.defaultChannel convenience over this. Authorization is the
	// host App's team-chat read gate; a Channel you may not read — or one that
	// does not exist — is CHANNEL_NOT_FOUND, identically.
	// TeamChatMessagesPage.total has the same cursor- and mention-filtered
	// meaning as for teamChatMessages, before paging.
	ChannelMessages *ChannelMessagesChannelMessagesTeamChatMessagesPage `json:"channelMessages"`
}

ChannelMessagesResponse is returned by ChannelMessages on success.

func ChannelMessages added in v0.14.0 

func ChannelMessages(
	ctx_ context.Context,
	client_ graphql.Client,
	channelRef string,
	sinceSeq *int,
	beforeSeq *int,
	limit *int,
	offset *int,
	mentionsRef *string,
) (data_ *ChannelMessagesResponse, err_ error)

Read a Channel's messages. channelRef is the id or the address.

sinceSeq is a watermark (strictly greater). beforeSeq pages BACKWARD and is the stable way to walk history: offset is a position in a list other people are appending to, so it skips or repeats under concurrent posting. offset is IGNORED when beforeSeq is given.

func (*ChannelMessagesResponse) GetChannelMessages added in v0.14.0 

func (v *ChannelMessagesResponse) GetChannelMessages() *ChannelMessagesChannelMessagesTeamChatMessagesPage

GetChannelMessages returns ChannelMessagesResponse.ChannelMessages, and is useful for accessing the field via an interface.

type ChannelReadStateChannelReadState added in v0.14.0 

type ChannelReadStateChannelReadState struct {
	ChannelId   string  `json:"channelId"`
	AttendeeUrn *string `json:"attendeeUrn"`
	LastSeenSeq int     `json:"lastSeenSeq"`
	UpdatedAt   string  `json:"updatedAt"`
}

ChannelReadStateChannelReadState includes the requested fields of the GraphQL type ChannelReadState. The GraphQL type's documentation follows.

Spec 049 Phase 7 — where an attendee is up to on a Channel (D-2026-09-13-009). Outside the register; keyed on the ATTENDEE (a Worker, or an Agent in an App); advances are monotonic. Mute is session state, never here.

func (*ChannelReadStateChannelReadState) GetAttendeeUrn added in v0.14.0 

func (v *ChannelReadStateChannelReadState) GetAttendeeUrn() *string

GetAttendeeUrn returns ChannelReadStateChannelReadState.AttendeeUrn, and is useful for accessing the field via an interface.

func (*ChannelReadStateChannelReadState) GetChannelId added in v0.14.0 

func (v *ChannelReadStateChannelReadState) GetChannelId() string

GetChannelId returns ChannelReadStateChannelReadState.ChannelId, and is useful for accessing the field via an interface.

func (*ChannelReadStateChannelReadState) GetLastSeenSeq added in v0.14.0 

func (v *ChannelReadStateChannelReadState) GetLastSeenSeq() int

GetLastSeenSeq returns ChannelReadStateChannelReadState.LastSeenSeq, and is useful for accessing the field via an interface.

func (*ChannelReadStateChannelReadState) GetUpdatedAt added in v0.14.0 

func (v *ChannelReadStateChannelReadState) GetUpdatedAt() string

GetUpdatedAt returns ChannelReadStateChannelReadState.UpdatedAt, and is useful for accessing the field via an interface.

type ChannelReadStateResponse added in v0.14.0 

type ChannelReadStateResponse struct {
	// Spec 049 Phase 7 — an attendee's cursor on a Channel (attendeeRef: a Worker,
	// or an Agent with appRef). Same gate as attendeeRegister; lastSeenSeq 0 when
	// the attendee has never checkpointed there; null when unreadable or unknown.
	// channelRef: the Channel's id or its address (`Channel.chatRootUrn`, #1171).
	ChannelReadState *ChannelReadStateChannelReadState `json:"channelReadState"`
}

ChannelReadStateResponse is returned by ChannelReadState on success.

func ChannelReadState added in v0.14.0 

func ChannelReadState(
	ctx_ context.Context,
	client_ graphql.Client,
	channelRef string,
	attendeeRef string,
	appRef *string,
) (data_ *ChannelReadStateResponse, err_ error)

Where an attendee is up to on a Channel.

func (*ChannelReadStateResponse) GetChannelReadState added in v0.14.0 

func (v *ChannelReadStateResponse) GetChannelReadState() *ChannelReadStateChannelReadState

GetChannelReadState returns ChannelReadStateResponse.ChannelReadState, and is useful for accessing the field via an interface.

type ChannelsChannelsChannelsPage added in v0.14.0 

type ChannelsChannelsChannelsPage struct {
	Total int                                         `json:"total"`
	Items []*ChannelsChannelsChannelsPageItemsChannel `json:"items"`
}

ChannelsChannelsChannelsPage includes the requested fields of the GraphQL type ChannelsPage.

func (*ChannelsChannelsChannelsPage) GetItems added in v0.14.0 

func (v *ChannelsChannelsChannelsPage) GetItems() []*ChannelsChannelsChannelsPageItemsChannel

GetItems returns ChannelsChannelsChannelsPage.Items, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPage) GetTotal added in v0.14.0 

func (v *ChannelsChannelsChannelsPage) GetTotal() int

GetTotal returns ChannelsChannelsChannelsPage.Total, and is useful for accessing the field via an interface.

type ChannelsChannelsChannelsPageItemsChannel added in v0.14.0 

type ChannelsChannelsChannelsPageItemsChannel struct {
	ChannelFields `json:"-"`
	ChannelMemory `json:"-"`
}

ChannelsChannelsChannelsPageItemsChannel includes the requested fields of the GraphQL type Channel. The GraphQL type's documentation follows.

A CHANNEL (spec 049, D-2026-09-13-006): a durable, ordered message stream hosted in ONE memory at ONE reserved address, server-ordered and server-attributed — a platform entity, created one-to-one with its chat root. Creating it RESERVES and PROTECTS the address: generic node writes under it are refused (LOC_PROTECTED); its own operations (createTeamChatMessage, hadron_team_chat_post) are the only writers. The audience is the host memory's (cor:acl:030:01) — a Channel has no access layer of its own. `lastSeq` / `lastMessageAt` are the platform-maintained watermark.

func (*ChannelsChannelsChannelsPageItemsChannel) GetChatRootNodeId added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetChatRootNodeId() string

GetChatRootNodeId returns ChannelsChannelsChannelsPageItemsChannel.ChatRootNodeId, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetChatRootUrn added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetChatRootUrn() *string

GetChatRootUrn returns ChannelsChannelsChannelsPageItemsChannel.ChatRootUrn, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetCreatedAt added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetCreatedAt() string

GetCreatedAt returns ChannelsChannelsChannelsPageItemsChannel.CreatedAt, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetDescription added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetDescription() *string

GetDescription returns ChannelsChannelsChannelsPageItemsChannel.Description, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetId added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetId() string

GetId returns ChannelsChannelsChannelsPageItemsChannel.Id, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetKind added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetKind() ChannelKind

GetKind returns ChannelsChannelsChannelsPageItemsChannel.Kind, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetLastMessageAt added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetLastMessageAt() *string

GetLastMessageAt returns ChannelsChannelsChannelsPageItemsChannel.LastMessageAt, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetLastSeq added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetLastSeq() int

GetLastSeq returns ChannelsChannelsChannelsPageItemsChannel.LastSeq, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetLoc added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetLoc() string

GetLoc returns ChannelsChannelsChannelsPageItemsChannel.Loc, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetMemory added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetMemory() *ChannelMemoryMemory

GetMemory returns ChannelsChannelsChannelsPageItemsChannel.Memory, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetMemoryId added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetMemoryId() string

GetMemoryId returns ChannelsChannelsChannelsPageItemsChannel.MemoryId, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetName added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetName() string

GetName returns ChannelsChannelsChannelsPageItemsChannel.Name, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) GetUpdatedAt added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) GetUpdatedAt() *string

GetUpdatedAt returns ChannelsChannelsChannelsPageItemsChannel.UpdatedAt, and is useful for accessing the field via an interface.

func (*ChannelsChannelsChannelsPageItemsChannel) MarshalJSON added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) MarshalJSON() ([]byte, error)

func (*ChannelsChannelsChannelsPageItemsChannel) UnmarshalJSON added in v0.14.0 

func (v *ChannelsChannelsChannelsPageItemsChannel) UnmarshalJSON(b []byte) error

type ChannelsResponse added in v0.14.0 

type ChannelsResponse struct {
	// Spec 049 Phase 4 — Channels whose host memory you may read, narrowed by an
	// App (its host memories' Channels) or by one memory, and by the cor:api:100:01
	// orgId. Loc-ascending (id tiebreak); limit default 50 / cap 200.
	Channels *ChannelsChannelsChannelsPage `json:"channels"`
}

ChannelsResponse is returned by Channels on success.

func Channels added in v0.14.0 

func Channels(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *ChannelFilter,
	limit *int,
	offset *int,
	orgId *string,
) (data_ *ChannelsResponse, err_ error)

Channels visible to the caller. ChannelFilter narrows by App or host memory.

func (*ChannelsResponse) GetChannels added in v0.14.0 

func (v *ChannelsResponse) GetChannels() *ChannelsChannelsChannelsPage

GetChannels returns ChannelsResponse.Channels, and is useful for accessing the field via an interface.

type ChatMessagesFindNodesFindNodesResult added in v0.7.0 

type ChatMessagesFindNodesFindNodesResult struct {
	Hits []*ChatMessagesFindNodesFindNodesResultHitsNodeHit `json:"hits"`
}

ChatMessagesFindNodesFindNodesResult includes the requested fields of the GraphQL type FindNodesResult. The GraphQL type's documentation follows.

Envelope for findNodes (cor:api:090) — the unified node list + search field (it replaced the removed nodes + nodeSearch queries). hits carry per-hit score + vector metadata; passages carry chunk-granularity results; reason/degraded surface no-index / reduced-fidelity outcomes.

func (*ChatMessagesFindNodesFindNodesResult) GetHits added in v0.7.0 

func (v *ChatMessagesFindNodesFindNodesResult) GetHits() []*ChatMessagesFindNodesFindNodesResultHitsNodeHit

GetHits returns ChatMessagesFindNodesFindNodesResult.Hits, and is useful for accessing the field via an interface.

type ChatMessagesFindNodesFindNodesResultHitsNodeHit added in v0.7.0 

type ChatMessagesFindNodesFindNodesResultHitsNodeHit struct {
	Node *ChatMessagesFindNodesFindNodesResultHitsNodeHitNode `json:"node"`
}

ChatMessagesFindNodesFindNodesResultHitsNodeHit includes the requested fields of the GraphQL type NodeHit. The GraphQL type's documentation follows.

A scored node hit (cor:api:090:04). score is null for an unscored filtered list (no query).

func (*ChatMessagesFindNodesFindNodesResultHitsNodeHit) GetNode added in v0.7.0 

func (v *ChatMessagesFindNodesFindNodesResultHitsNodeHit) GetNode() *ChatMessagesFindNodesFindNodesResultHitsNodeHitNode

GetNode returns ChatMessagesFindNodesFindNodesResultHitsNodeHit.Node, and is useful for accessing the field via an interface.

type ChatMessagesFindNodesFindNodesResultHitsNodeHitNode added in v0.7.0 

type ChatMessagesFindNodesFindNodesResultHitsNodeHitNode struct {
	Loc     string           `json:"loc"`
	Seq     *int             `json:"seq"`
	Content *string          `json:"content"`
	Data    *json.RawMessage `json:"data"`
}

ChatMessagesFindNodesFindNodesResultHitsNodeHitNode includes the requested fields of the GraphQL type Node.

func (*ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetContent added in v0.9.0 

func (v *ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetContent() *string

GetContent returns ChatMessagesFindNodesFindNodesResultHitsNodeHitNode.Content, and is useful for accessing the field via an interface.

func (*ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetData added in v0.7.0 

func (v *ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetData() *json.RawMessage

GetData returns ChatMessagesFindNodesFindNodesResultHitsNodeHitNode.Data, and is useful for accessing the field via an interface.

func (*ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetLoc added in v0.7.0 

func (v *ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetLoc() string

GetLoc returns ChatMessagesFindNodesFindNodesResultHitsNodeHitNode.Loc, and is useful for accessing the field via an interface.

func (*ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetSeq added in v0.7.0 

func (v *ChatMessagesFindNodesFindNodesResultHitsNodeHitNode) GetSeq() *int

GetSeq returns ChatMessagesFindNodesFindNodesResultHitsNodeHitNode.Seq, and is useful for accessing the field via an interface.

type ChatMessagesResponse added in v0.7.0 

type ChatMessagesResponse struct {
	// Unified node search (cor:api:090) — the single node list + retrieval
	// surface (it replaced the removed `nodes` filter/list and `nodeSearch`
	// rank queries in PR3). Omit `query` for a filtered list in deterministic
	// order (subsumes `nodes`); pass `query` to rank by `mode`
	// (keyword | vector | hybrid | regex). Lexical modes honor boolean operators
	// (`(a OR b) AND c`, quoted phrases, NOT/-) — operator words are
	// UPPERCASE-ONLY, so natural phrases like 'not sure' search literally —
	// and `fields` as a ranking weight-mask. Malformed boolean syntax
	// (unmatched parenthesis, unterminated quote) DEGRADES to a literal phrase
	// search flagged `degraded: 'literal_fallback'` instead of erroring; only
	// mode: regex fails loudly on bad syntax. `filter` is the structured, AND-combined filter context
	// (SYSTEM memory class excluded by default; explicit wins). Returns a
	// scored-hit envelope. Access-scoped identically to the per-kind node queries.
	//
	// orgId (optional) narrows the accessible scope to a single organization the
	// caller is a member of; a non-member orgId returns an empty envelope
	// (total 0, no existence disclosure). Combined with filter.isRunnable: true
	// this is the canonical "the caller's runnable task nodes in one org" query
	// (there is no separate myTasks surface — a task is simply an isRunnable node).
	FindNodes *ChatMessagesFindNodesFindNodesResult `json:"findNodes"`
}

ChatMessagesResponse is returned by ChatMessages on success.

func ChatMessages added in v0.7.0 

func ChatMessages(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *NodeFilter,
	limit *int,
	offset *int,
) (data_ *ChatMessagesResponse, err_ error)

Team-chat reads (hadron chat read). Messages are chat-message nodes under a `messagesLoc` prefix — canonical shape (D-2026-08-07-001/-004): the body in `content`, the envelope (author/timestamp/…) in `data`. `content` AND `data` are selected so one findNodes call returns everything, and so the legacy academy dialect (body in data.body, `message` nodeType) still reads — accept everything, emit canonical. sort: seq gives server-assigned order; the CLI paginates to exhaustion and filters seq>since client-side (there is no server-side seq cursor).

NodeFilter is a SHARED generated struct, and genqlient resolves a shared input type's field-level omitempty per-operation with last-writer-wins (not a merge). So this op must repeat FindNodes' (nodes.graphql) FULL set verbatim — a partial or empty set here would non-deterministically strip omitempty off the struct depending on generation order. Keep these two lists identical.

func (*ChatMessagesResponse) GetFindNodes added in v0.7.0 

func (v *ChatMessagesResponse) GetFindNodes() *ChatMessagesFindNodesFindNodesResult

GetFindNodes returns ChatMessagesResponse.FindNodes, and is useful for accessing the field via an interface.

type ClearNodeHistoryResponse added in v0.7.0 

type ClearNodeHistoryResponse struct {
	// Delete ALL NodeRevision rows for a node, returning the count deleted (#617).
	// 'nodeRef' is the node's PK or fully-qualified URN. Auth: the node's memory
	// write access. An unknown ref throws NODE_NOT_FOUND. Reachable on a
	// soft-deleted node (purging residual history is a cleanup op).
	ClearNodeHistory int `json:"clearNodeHistory"`
}

ClearNodeHistoryResponse is returned by ClearNodeHistory on success.

func ClearNodeHistory added in v0.7.0 

func ClearNodeHistory(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
) (data_ *ClearNodeHistoryResponse, err_ error)

Delete all of a node's snapshots, returning the count. Reachable on soft-deleted nodes (cleanup), so callers may pass a PK the read surfaces no longer resolve.

func (*ClearNodeHistoryResponse) GetClearNodeHistory added in v0.7.0 

func (v *ClearNodeHistoryResponse) GetClearNodeHistory() int

GetClearNodeHistory returns ClearNodeHistoryResponse.ClearNodeHistory, and is useful for accessing the field via an interface.

type CloneMemoryCloneMemory added in v0.2.0 

type CloneMemoryCloneMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

CloneMemoryCloneMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*CloneMemoryCloneMemory) GetClass added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetClass() MemoryClass

GetClass returns CloneMemoryCloneMemory.Class, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetId added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetId() string

GetId returns CloneMemoryCloneMemory.Id, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetIsEncrypted added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetIsEncrypted() bool

GetIsEncrypted returns CloneMemoryCloneMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetMaxRevCount added in v0.7.0 

func (v *CloneMemoryCloneMemory) GetMaxRevCount() int

GetMaxRevCount returns CloneMemoryCloneMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetName added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetName() string

GetName returns CloneMemoryCloneMemory.Name, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetOrganizationId added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetOrganizationId() *string

GetOrganizationId returns CloneMemoryCloneMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetShortDescription added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetShortDescription() *string

GetShortDescription returns CloneMemoryCloneMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetUpdatedAt added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetUpdatedAt() string

GetUpdatedAt returns CloneMemoryCloneMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetUrn added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetUrn() string

GetUrn returns CloneMemoryCloneMemory.Urn, and is useful for accessing the field via an interface.

func (*CloneMemoryCloneMemory) GetVisibility added in v0.2.0 

func (v *CloneMemoryCloneMemory) GetVisibility() *MemoryVisibility

GetVisibility returns CloneMemoryCloneMemory.Visibility, and is useful for accessing the field via an interface.

type CloneMemoryResponse added in v0.2.0 

type CloneMemoryResponse struct {
	// Clone a Memory into a new Memory at `targetUrn`.
	//
	// `ref` accepts the source's ID or URN. `targetUrn` is a fully-qualified
	// "root:slug" memory URN naming the clone; its org segment MAY differ from
	// the source's, cloning the memory into another organization. The clone's
	// display name is derived from the target slug.
	//
	// 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: revision 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: the SOURCE side mirrors deleteMemory (personal/private →
	// owner only; knowledge/group → source-org ADMIN). When `targetUrn` names a
	// DIFFERENT org, the caller must additionally be a non-reader member of that
	// target org. system/app-class sources and encrypted memories are rejected.
	CloneMemory *CloneMemoryCloneMemory `json:"cloneMemory"`
}

CloneMemoryResponse is returned by CloneMemory on success.

func CloneMemory added in v0.2.0 

func CloneMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	targetUrn string,
) (data_ *CloneMemoryResponse, err_ error)

func (*CloneMemoryResponse) GetCloneMemory added in v0.2.0 

func (v *CloneMemoryResponse) GetCloneMemory() *CloneMemoryCloneMemory

GetCloneMemory returns CloneMemoryResponse.CloneMemory, and is useful for accessing the field via an interface.

type CloneNodeCloneNode added in v0.7.0 

type CloneNodeCloneNode struct {
	Id string `json:"id"`
	// Fully-qualified node URN (hrn:node:<root>:<memory>:<loc>), composed server-side from the node's memory URN + loc (#481). Carried by every Node-returning surface (findNodes, node, appNodes, nodeBatch, mutation returns).
	Urn      string `json:"urn"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string `json:"nodeType"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role *string  `json:"role"`
	Tags []string `json:"tags"`
	Seq  *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool  `json:"isRunnable"`
	UpdatedAt  string `json:"updatedAt"`
}

CloneNodeCloneNode includes the requested fields of the GraphQL type Node.

func (*CloneNodeCloneNode) GetId added in v0.7.0 

func (v *CloneNodeCloneNode) GetId() string

GetId returns CloneNodeCloneNode.Id, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetIsRunnable added in v0.7.0 

func (v *CloneNodeCloneNode) GetIsRunnable() *bool

GetIsRunnable returns CloneNodeCloneNode.IsRunnable, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetLoc added in v0.7.0 

func (v *CloneNodeCloneNode) GetLoc() string

GetLoc returns CloneNodeCloneNode.Loc, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetMemoryId added in v0.7.0 

func (v *CloneNodeCloneNode) GetMemoryId() string

GetMemoryId returns CloneNodeCloneNode.MemoryId, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetName added in v0.7.0 

func (v *CloneNodeCloneNode) GetName() string

GetName returns CloneNodeCloneNode.Name, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetNodeType added in v0.7.0 

func (v *CloneNodeCloneNode) GetNodeType() string

GetNodeType returns CloneNodeCloneNode.NodeType, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetRole added in v0.15.0 

func (v *CloneNodeCloneNode) GetRole() *string

GetRole returns CloneNodeCloneNode.Role, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetSeq added in v0.14.0 

func (v *CloneNodeCloneNode) GetSeq() *int

GetSeq returns CloneNodeCloneNode.Seq, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetTags added in v0.7.0 

func (v *CloneNodeCloneNode) GetTags() []string

GetTags returns CloneNodeCloneNode.Tags, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetUpdatedAt added in v0.7.0 

func (v *CloneNodeCloneNode) GetUpdatedAt() string

GetUpdatedAt returns CloneNodeCloneNode.UpdatedAt, and is useful for accessing the field via an interface.

func (*CloneNodeCloneNode) GetUrn added in v0.7.0 

func (v *CloneNodeCloneNode) GetUrn() string

GetUrn returns CloneNodeCloneNode.Urn, and is useful for accessing the field via an interface.

type CloneNodeResponse added in v0.7.0 

type CloneNodeResponse struct {
	// Clone a node to a new location, returning the NEW node with a fresh id
	// (#564). Same selector shape as moveNode ('sourceRef' + exactly one of
	// 'targetUrn' / 'targetMemoryRef'). Copies the source's own fields; outgoing
	// edges are copied only where they naturally resolve — a live node exists at
	// the target's loc in the destination memory. Incoming edges are not copied.
	// Fails loudly if the destination loc is already occupied. Requires read
	// access to the source memory and write access to the destination.
	CloneNode *CloneNodeCloneNode `json:"cloneNode"`
}

CloneNodeResponse is returned by CloneNode on success.

func CloneNode added in v0.7.0 

func CloneNode(
	ctx_ context.Context,
	client_ graphql.Client,
	sourceRef string,
	targetUrn *string,
	targetMemoryRef *string,
) (data_ *CloneNodeResponse, err_ error)

Clone a node to a new location, returning the NEW node with a fresh id (#564). Same selector shape as MoveNode ($sourceRef + exactly one of $targetUrn / $targetMemoryRef). Copies the node's own fields plus the outgoing edges that naturally resolve at the destination; incoming edges are not copied. Backs `hadron node clone`.

func (*CloneNodeResponse) GetCloneNode added in v0.7.0 

func (v *CloneNodeResponse) GetCloneNode() *CloneNodeCloneNode

GetCloneNode returns CloneNodeResponse.CloneNode, and is useful for accessing the field via an interface.

type CompleteAssetUploadCompleteAssetUploadAsset added in v0.9.0 

type CompleteAssetUploadCompleteAssetUploadAsset struct {
	Id string `json:"id"`
	// The asset's URN, grammar v2 (cor:urn:010:01): hrn:asset:<root>:<mem...>:assets:<asset.id>,
	// emitted by emitAssetUrnV2 from the holding memory's STORED urn.
	//
	// <mem...> is one or more atoms, not always one. A per-user memory urn minted
	// before the #697 Stage-3 flip is still compound (<root>:<agent>:app-user:<id>
	// and friends), and each extra memory atom lengthens the asset URN with it —
	// so the 'assets' marker is not at a fixed offset. A parser recovering the
	// holding memory must take everything between the type word and that marker,
	// never a fixed two-atom prefix. Prefer locating the LAST 'assets' atom and
	// reading the id after it (assetIdFromRef does exactly this).
	//
	// Two degraded shapes a parser must tolerate, both of which really occur:
	// * hrn:asset:unknown:assets:<asset.id> — the holding memory row could not
	// be loaded. Carries no memory identity at all.
	// * <memory.urn>:assets:<asset.id> — the pre-#697 shape, with NO hrn:asset:
	// prefix, served when v2 emission throws (empty, over-length or
	// charset-invalid atom in the stored memory urn). It interpolates the
	// stored memory urn verbatim, which is normally bare (<root>:<slug>), so
	// this shape usually looks like acme.com:docs:assets:<id>.
	//
	// A third oddity is reachable through the NORMAL branch, not a fallback: a
	// legacy memories.urn row that predates the chk_memory_urn_not_prefixed
	// guardrail can still hold a rendered hrn:mem:-prefixed value, and that
	// composes into hrn:asset:hrn:mem:<root>:<slug>:assets:<id>. A prefix strip
	// that assumes one leading type word will mis-read it.
	Urn        string          `json:"urn"`
	Filename   string          `json:"filename"`
	MimeType   string          `json:"mimeType"`
	SizeBytes  int             `json:"sizeBytes"`
	ScanStatus AssetScanStatus `json:"scanStatus"`
	UploadedAt string          `json:"uploadedAt"`
	MemoryId   string          `json:"memoryId"`
	// Stable, UNAUTHENTICATED hotlink to the bytes (GET /assets/<id>).
	//
	// Anyone with this URL can fetch the file — there is no read gate on
	// it. A deliberate, temporary posture; see src/api/assetPublic.ts. Do
	// not present it in a UI as though it were access-controlled.
	//
	// Null when the server has no BASE_URL configured (no canonical
	// origin to build an absolute URL from), when the asset is not
	// CLEAN, or when its memory is encrypted — encrypted memories are
	// never hotlinkable, since an anonymous request holds no session key.
	PublicUrl *string `json:"publicUrl"`
}

CompleteAssetUploadCompleteAssetUploadAsset includes the requested fields of the GraphQL type Asset.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetFilename added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetFilename() string

GetFilename returns CompleteAssetUploadCompleteAssetUploadAsset.Filename, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetId added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetId() string

GetId returns CompleteAssetUploadCompleteAssetUploadAsset.Id, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetMemoryId added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetMemoryId() string

GetMemoryId returns CompleteAssetUploadCompleteAssetUploadAsset.MemoryId, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetMimeType added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetMimeType() string

GetMimeType returns CompleteAssetUploadCompleteAssetUploadAsset.MimeType, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetPublicUrl added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetPublicUrl() *string

GetPublicUrl returns CompleteAssetUploadCompleteAssetUploadAsset.PublicUrl, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetScanStatus added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetScanStatus() AssetScanStatus

GetScanStatus returns CompleteAssetUploadCompleteAssetUploadAsset.ScanStatus, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetSizeBytes added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetSizeBytes() int

GetSizeBytes returns CompleteAssetUploadCompleteAssetUploadAsset.SizeBytes, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetUploadedAt added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetUploadedAt() string

GetUploadedAt returns CompleteAssetUploadCompleteAssetUploadAsset.UploadedAt, and is useful for accessing the field via an interface.

func (*CompleteAssetUploadCompleteAssetUploadAsset) GetUrn added in v0.9.0 

func (v *CompleteAssetUploadCompleteAssetUploadAsset) GetUrn() string

GetUrn returns CompleteAssetUploadCompleteAssetUploadAsset.Urn, and is useful for accessing the field via an interface.

type CompleteAssetUploadResponse added in v0.9.0 

type CompleteAssetUploadResponse struct {
	CompleteAssetUpload *CompleteAssetUploadCompleteAssetUploadAsset `json:"completeAssetUpload"`
}

CompleteAssetUploadResponse is returned by CompleteAssetUpload on success.

func CompleteAssetUpload added in v0.9.0 

func CompleteAssetUpload(
	ctx_ context.Context,
	client_ graphql.Client,
	uploadId string,
) (data_ *CompleteAssetUploadResponse, err_ error)

Step 3 of 3 (step 2 is the PUT, which is plain HTTP against object storage). Until this lands the asset row is reserved but not usable — an upload that dies after the PUT leaves a reservation, not a half-visible asset.

func (*CompleteAssetUploadResponse) GetCompleteAssetUpload added in v0.9.0 

func (v *CompleteAssetUploadResponse) GetCompleteAssetUpload() *CompleteAssetUploadCompleteAssetUploadAsset

GetCompleteAssetUpload returns CompleteAssetUploadResponse.CompleteAssetUpload, and is useful for accessing the field via an interface.

type ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult added in v0.18.0 

type ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult struct {
	Applied          bool `json:"applied"`
	WorkersAdvanced  int  `json:"workersAdvanced"`
	ChannelsAdvanced int  `json:"channelsAdvanced"`
}

ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult includes the requested fields of the GraphQL type TeamAttentionSwitchoverResult.

func (*ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult) GetApplied added in v0.18.0 

func (v *ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult) GetApplied() bool

GetApplied returns ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult.Applied, and is useful for accessing the field via an interface.

func (*ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult) GetChannelsAdvanced added in v0.18.0 

func (v *ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult) GetChannelsAdvanced() int

GetChannelsAdvanced returns ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult.ChannelsAdvanced, and is useful for accessing the field via an interface.

func (*ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult) GetWorkersAdvanced added in v0.18.0 

func (v *ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult) GetWorkersAdvanced() int

GetWorkersAdvanced returns ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult.WorkersAdvanced, and is useful for accessing the field via an interface.

type ConfirmTeamAttentionSwitchoverResponse added in v0.18.0 

type ConfirmTeamAttentionSwitchoverResponse struct {
	// Explicitly confirm a previously previewed #1353 switchover. The proof is
	// actor/App/scope-bound; any live-Worker, register or cursor drift rejects
	// the whole transaction. It advances only through the heads captured by the
	// preview, so messages arriving afterward remain unread.
	ConfirmTeamAttentionSwitchover *ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult `json:"confirmTeamAttentionSwitchover"`
}

ConfirmTeamAttentionSwitchoverResponse is returned by ConfirmTeamAttentionSwitchover on success.

func ConfirmTeamAttentionSwitchover added in v0.18.0 

func ConfirmTeamAttentionSwitchover(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	proof string,
) (data_ *ConfirmTeamAttentionSwitchoverResponse, err_ error)

The confirmed half: advances every previewed worker through the previewed heads only, atomically, or refuses on any drift.

func (*ConfirmTeamAttentionSwitchoverResponse) GetConfirmTeamAttentionSwitchover added in v0.18.0 

func (v *ConfirmTeamAttentionSwitchoverResponse) GetConfirmTeamAttentionSwitchover() *ConfirmTeamAttentionSwitchoverConfirmTeamAttentionSwitchoverTeamAttentionSwitchoverResult

GetConfirmTeamAttentionSwitchover returns ConfirmTeamAttentionSwitchoverResponse.ConfirmTeamAttentionSwitchover, and is useful for accessing the field via an interface.

type ConnectionGrantFields added in v0.7.0 

type ConnectionGrantFields struct {
	Id           string `json:"id"`
	ConnectionId string `json:"connectionId"`
	// The App install this grant delegates to.
	GranteeAppId   string  `json:"granteeAppId"`
	GranteeAppName *string `json:"granteeAppName"`
	// Canonical URN of the grantee App (hrn:app:<root>:<slug>), or null if unresolvable.
	GranteeAppUrn *string `json:"granteeAppUrn"`
	// Covered scopes: mail.read, mail.send, calendar.freebusy, calendar.read, drive.read.
	Scopes []string `json:"scopes"`
	// ISO-8601 expiry, or null for perpetual (until revoked).
	ExpiresAt *string `json:"expiresAt"`
	CreatedAt string  `json:"createdAt"`
}

ConnectionGrantFields includes the GraphQL fields of ConnectionGrant requested by the fragment ConnectionGrantFields. The GraphQL type's documentation follows.

A user-owned connection's scoped delegation to an App install (spec-042 Track B, #593). The connection OWNER grants a specific App scoped access to their mailbox/calendar; the enforcement gate is requireEmailConnection. The grantee App is exposed as SCALARS only (never a nested App object), so a cross-org grant can't reach the App keys/members. Token material is never exposed.

func (*ConnectionGrantFields) GetConnectionId added in v0.7.0 

func (v *ConnectionGrantFields) GetConnectionId() string

GetConnectionId returns ConnectionGrantFields.ConnectionId, and is useful for accessing the field via an interface.

func (*ConnectionGrantFields) GetCreatedAt added in v0.7.0 

func (v *ConnectionGrantFields) GetCreatedAt() string

GetCreatedAt returns ConnectionGrantFields.CreatedAt, and is useful for accessing the field via an interface.

func (*ConnectionGrantFields) GetExpiresAt added in v0.7.0 

func (v *ConnectionGrantFields) GetExpiresAt() *string

GetExpiresAt returns ConnectionGrantFields.ExpiresAt, and is useful for accessing the field via an interface.

func (*ConnectionGrantFields) GetGranteeAppId added in v0.7.0 

func (v *ConnectionGrantFields) GetGranteeAppId() string

GetGranteeAppId returns ConnectionGrantFields.GranteeAppId, and is useful for accessing the field via an interface.

func (*ConnectionGrantFields) GetGranteeAppName added in v0.7.0 

func (v *ConnectionGrantFields) GetGranteeAppName() *string

GetGranteeAppName returns ConnectionGrantFields.GranteeAppName, and is useful for accessing the field via an interface.

func (*ConnectionGrantFields) GetGranteeAppUrn added in v0.7.0 

func (v *ConnectionGrantFields) GetGranteeAppUrn() *string

GetGranteeAppUrn returns ConnectionGrantFields.GranteeAppUrn, and is useful for accessing the field via an interface.

func (*ConnectionGrantFields) GetId added in v0.7.0 

func (v *ConnectionGrantFields) GetId() string

GetId returns ConnectionGrantFields.Id, and is useful for accessing the field via an interface.

func (*ConnectionGrantFields) GetScopes added in v0.7.0 

func (v *ConnectionGrantFields) GetScopes() []string

GetScopes returns ConnectionGrantFields.Scopes, and is useful for accessing the field via an interface.

type ConnectionGrantsConnectionGrantsConnectionGrantsPage added in v0.7.0 

type ConnectionGrantsConnectionGrantsConnectionGrantsPage struct {
	Items []*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant `json:"items"`
	Total int                                                                         `json:"total"`
}

ConnectionGrantsConnectionGrantsConnectionGrantsPage includes the requested fields of the GraphQL type ConnectionGrantsPage.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPage) GetItems added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPage) GetItems() []*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant

GetItems returns ConnectionGrantsConnectionGrantsConnectionGrantsPage.Items, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPage) GetTotal added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPage) GetTotal() int

GetTotal returns ConnectionGrantsConnectionGrantsConnectionGrantsPage.Total, and is useful for accessing the field via an interface.

type ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant added in v0.7.0 

type ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant struct {
	ConnectionGrantFields `json:"-"`
}

ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant includes the requested fields of the GraphQL type ConnectionGrant. The GraphQL type's documentation follows.

A user-owned connection's scoped delegation to an App install (spec-042 Track B, #593). The connection OWNER grants a specific App scoped access to their mailbox/calendar; the enforcement gate is requireEmailConnection. The grantee App is exposed as SCALARS only (never a nested App object), so a cross-org grant can't reach the App keys/members. Token material is never exposed.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetConnectionId added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetConnectionId() string

GetConnectionId returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.ConnectionId, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetCreatedAt added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetCreatedAt() string

GetCreatedAt returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.CreatedAt, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetExpiresAt added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetExpiresAt() *string

GetExpiresAt returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.ExpiresAt, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetGranteeAppId added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetGranteeAppId() string

GetGranteeAppId returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.GranteeAppId, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetGranteeAppName added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetGranteeAppName() *string

GetGranteeAppName returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.GranteeAppName, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetGranteeAppUrn added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetGranteeAppUrn() *string

GetGranteeAppUrn returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.GranteeAppUrn, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetId added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetId() string

GetId returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.Id, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetScopes added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) GetScopes() []string

GetScopes returns ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant.Scopes, and is useful for accessing the field via an interface.

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) MarshalJSON added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) MarshalJSON() ([]byte, error)

func (*ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) UnmarshalJSON added in v0.7.0 

func (v *ConnectionGrantsConnectionGrantsConnectionGrantsPageItemsConnectionGrant) UnmarshalJSON(b []byte) error

type ConnectionGrantsResponse added in v0.7.0 

type ConnectionGrantsResponse struct {
	// The caller's own connection grants; connectionRef narrows to one connection.
	ConnectionGrants *ConnectionGrantsConnectionGrantsConnectionGrantsPage `json:"connectionGrants"`
}

ConnectionGrantsResponse is returned by ConnectionGrants on success.

func ConnectionGrants added in v0.7.0 

func ConnectionGrants(
	ctx_ context.Context,
	client_ graphql.Client,
	connectionRef *string,
	limit *int,
	offset *int,
) (data_ *ConnectionGrantsResponse, err_ error)

Grants on the caller's connections, optionally narrowed to one connection.

func (*ConnectionGrantsResponse) GetConnectionGrants added in v0.7.0 

func (v *ConnectionGrantsResponse) GetConnectionGrants() *ConnectionGrantsConnectionGrantsConnectionGrantsPage

GetConnectionGrants returns ConnectionGrantsResponse.ConnectionGrants, and is useful for accessing the field via an interface.

type ContentValidator added in v0.18.0 

type ContentValidator string
const (
	ContentValidatorAgent    ContentValidator = "AGENT"
	ContentValidatorPlatform ContentValidator = "PLATFORM"
)

type CorpusState added in v0.18.0 

type CorpusState string

#1447 — a spec corpus's state, derived from its nodes since #1591: DRAFT while no live node is minted, MINTED once any is. 

const (
	CorpusStateDraft  CorpusState = "DRAFT"
	CorpusStateMinted CorpusState = "MINTED"
)

type CreateAgentCreateAgent added in v0.7.0 

type CreateAgentCreateAgent struct {
	AgentFields `json:"-"`
}

CreateAgentCreateAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*CreateAgentCreateAgent) GetAiModel added in v0.7.0 

func (v *CreateAgentCreateAgent) GetAiModel() *string

GetAiModel returns CreateAgentCreateAgent.AiModel, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetAiProvider added in v0.7.0 

func (v *CreateAgentCreateAgent) GetAiProvider() *string

GetAiProvider returns CreateAgentCreateAgent.AiProvider, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetCreatedAt added in v0.7.0 

func (v *CreateAgentCreateAgent) GetCreatedAt() string

GetCreatedAt returns CreateAgentCreateAgent.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetDescription added in v0.7.0 

func (v *CreateAgentCreateAgent) GetDescription() *string

GetDescription returns CreateAgentCreateAgent.Description, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetHasAiApiKey added in v0.7.0 

func (v *CreateAgentCreateAgent) GetHasAiApiKey() bool

GetHasAiApiKey returns CreateAgentCreateAgent.HasAiApiKey, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetId added in v0.7.0 

func (v *CreateAgentCreateAgent) GetId() string

GetId returns CreateAgentCreateAgent.Id, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetName added in v0.7.0 

func (v *CreateAgentCreateAgent) GetName() string

GetName returns CreateAgentCreateAgent.Name, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetOrganizationId added in v0.7.0 

func (v *CreateAgentCreateAgent) GetOrganizationId() *string

GetOrganizationId returns CreateAgentCreateAgent.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetPersonaRole added in v0.9.0 

func (v *CreateAgentCreateAgent) GetPersonaRole() *string

GetPersonaRole returns CreateAgentCreateAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetSurfaces added in v0.7.0 

func (v *CreateAgentCreateAgent) GetSurfaces() []string

GetSurfaces returns CreateAgentCreateAgent.Surfaces, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetSystemMemoryId added in v0.7.0 

func (v *CreateAgentCreateAgent) GetSystemMemoryId() *string

GetSystemMemoryId returns CreateAgentCreateAgent.SystemMemoryId, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetSystemPrompt added in v0.7.0 

func (v *CreateAgentCreateAgent) GetSystemPrompt() *string

GetSystemPrompt returns CreateAgentCreateAgent.SystemPrompt, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetType added in v0.7.0 

func (v *CreateAgentCreateAgent) GetType() AgentType

GetType returns CreateAgentCreateAgent.Type, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetUrn added in v0.7.0 

func (v *CreateAgentCreateAgent) GetUrn() string

GetUrn returns CreateAgentCreateAgent.Urn, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) GetVisibility added in v0.7.0 

func (v *CreateAgentCreateAgent) GetVisibility() AgentVisibility

GetVisibility returns CreateAgentCreateAgent.Visibility, and is useful for accessing the field via an interface.

func (*CreateAgentCreateAgent) MarshalJSON added in v0.7.0 

func (v *CreateAgentCreateAgent) MarshalJSON() ([]byte, error)

func (*CreateAgentCreateAgent) UnmarshalJSON added in v0.7.0 

func (v *CreateAgentCreateAgent) UnmarshalJSON(b []byte) error

type CreateAgentResponse added in v0.7.0 

type CreateAgentResponse struct {
	// Create an agent. Provide orgId to create an ORG-owned agent (requires org
	// ADMIN); OMIT orgId to create a USER-OWNED agent owned by the caller — its
	// URN is rooted on the caller's bare handle (hrn:agent:<handle>:<slug>, grammar
	// v2 — no @ sigil) and its system memory is user-owned too. Exactly one owner
	// (org XOR user).
	//
	// personaRole and systemPrompt are the persona dressing (cor:agt:020:01) —
	// the reusable role plus the '{{name}}'-templated prompt. The NAMED
	// identity is a Worker, cast with castWorker; names never live on agents.
	//
	// orgId accepts the org's ID or URN.
	CreateAgent *CreateAgentCreateAgent `json:"createAgent"`
}

CreateAgentResponse is returned by CreateAgent on success.

func CreateAgent added in v0.7.0 

func CreateAgent(
	ctx_ context.Context,
	client_ graphql.Client,
	name string,
	orgId *string,
	description *string,
	agentType *AgentType,
	visibility *AgentVisibility,
	systemPrompt *string,
	systemMemoryId *string,
	surfaces []string,
	personaRole *string,
) (data_ *CreateAgentResponse, err_ error)

func (*CreateAgentResponse) GetCreateAgent added in v0.7.0 

func (v *CreateAgentResponse) GetCreateAgent() *CreateAgentCreateAgent

GetCreateAgent returns CreateAgentResponse.CreateAgent, and is useful for accessing the field via an interface.

type CreateAgentScheduleCreateAgentSchedule added in v0.6.0 

type CreateAgentScheduleCreateAgentSchedule struct {
	AgentScheduleFields `json:"-"`
}

CreateAgentScheduleCreateAgentSchedule includes the requested fields of the GraphQL type AgentSchedule. The GraphQL type's documentation follows.

Recurring trigger (cor:agt:010, D-2026-07-04-E).

func (*CreateAgentScheduleCreateAgentSchedule) GetAgentId added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetAgentId() *string

GetAgentId returns CreateAgentScheduleCreateAgentSchedule.AgentId, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetAiConfigName added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetAiConfigName() *string

GetAiConfigName returns CreateAgentScheduleCreateAgentSchedule.AiConfigName, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetAppId added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetAppId() string

GetAppId returns CreateAgentScheduleCreateAgentSchedule.AppId, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetCreatedAt added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetCreatedAt() string

GetCreatedAt returns CreateAgentScheduleCreateAgentSchedule.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetCreatedBy added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetCreatedBy() *string

GetCreatedBy returns CreateAgentScheduleCreateAgentSchedule.CreatedBy, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetCron added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetCron() *string

GetCron returns CreateAgentScheduleCreateAgentSchedule.Cron, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetEnabled added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetEnabled() bool

GetEnabled returns CreateAgentScheduleCreateAgentSchedule.Enabled, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetEntryNodeUrn added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetEntryNodeUrn() string

GetEntryNodeUrn returns CreateAgentScheduleCreateAgentSchedule.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetEventData added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetEventData() *json.RawMessage

GetEventData returns CreateAgentScheduleCreateAgentSchedule.EventData, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetId added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetId() string

GetId returns CreateAgentScheduleCreateAgentSchedule.Id, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetLastRunAt added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetLastRunAt() *string

GetLastRunAt returns CreateAgentScheduleCreateAgentSchedule.LastRunAt, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetName added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetName() string

GetName returns CreateAgentScheduleCreateAgentSchedule.Name, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetNextRunAt added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetNextRunAt() *string

GetNextRunAt returns CreateAgentScheduleCreateAgentSchedule.NextRunAt, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetOrganizationId added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetOrganizationId() string

GetOrganizationId returns CreateAgentScheduleCreateAgentSchedule.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetPolicy added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetPolicy() *json.RawMessage

GetPolicy returns CreateAgentScheduleCreateAgentSchedule.Policy, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetTimezone added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetTimezone() string

GetTimezone returns CreateAgentScheduleCreateAgentSchedule.Timezone, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) GetUserId added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) GetUserId() *string

GetUserId returns CreateAgentScheduleCreateAgentSchedule.UserId, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleCreateAgentSchedule) MarshalJSON added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) MarshalJSON() ([]byte, error)

func (*CreateAgentScheduleCreateAgentSchedule) UnmarshalJSON added in v0.6.0 

func (v *CreateAgentScheduleCreateAgentSchedule) UnmarshalJSON(b []byte) error

type CreateAgentScheduleInput added in v0.6.0 

type CreateAgentScheduleInput struct {
	// Agent — ref: PK or URN; must be installed in the App.
	AgentRef *string `json:"agentRef,omitempty"`
	// Named AI config for this trigger (spec-036 walk override).
	AiConfigName *string `json:"aiConfigName,omitempty"`
	// App the run executes as — ref: PK or fully-qualified URN.
	AppRef string `json:"appRef"`
	// Recurring: 5-field cron expression, evaluated in timezone (default UTC). Provide exactly one of cron / runAt.
	Cron    *string `json:"cron"`
	Enabled *bool   `json:"enabled,omitempty"`
	// Fully-qualified URN of the prompt node to run (D-2026-05-09-012/017).
	EntryNodeUrn string `json:"entryNodeUrn"`
	// Static payload merged into each run's template args.
	EventData *json.RawMessage `json:"eventData,omitempty"`
	Name      string           `json:"name"`
	// Trigger-layer allow-list { allow: [...] } — one link of the conjunctive chain (cor:acl:040).
	Policy *json.RawMessage `json:"policy,omitempty"`
	// true: the run acts on behalf of YOU (required to reach your personal memories). v1 never delegates a third party (cor:agt:010:01).
	RunAsSelf *bool `json:"runAsSelf,omitempty"`
	// One-shot: run once at this ISO-8601 instant (#510). Provide exactly one of cron / runAt.
	RunAt *string `json:"runAt,omitempty"`
	// Spec 049 (D-2026-09-13-004): the scope this trigger's runs carry — a scope id, or a name resolved in the App's context (App › Agent › organization). Must be readable by you and resolvable in that App. Snapshotted onto each run at mint; omitted ⇒ the App's attached memories ('app').
	ScopeRef *string `json:"scopeRef,omitempty"`
	Timezone *string `json:"timezone,omitempty"`
}

func (*CreateAgentScheduleInput) GetAgentRef added in v0.7.0 

func (v *CreateAgentScheduleInput) GetAgentRef() *string

GetAgentRef returns CreateAgentScheduleInput.AgentRef, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetAiConfigName added in v0.6.0 

func (v *CreateAgentScheduleInput) GetAiConfigName() *string

GetAiConfigName returns CreateAgentScheduleInput.AiConfigName, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetAppRef added in v0.7.0 

func (v *CreateAgentScheduleInput) GetAppRef() string

GetAppRef returns CreateAgentScheduleInput.AppRef, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetCron added in v0.6.0 

func (v *CreateAgentScheduleInput) GetCron() *string

GetCron returns CreateAgentScheduleInput.Cron, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetEnabled added in v0.6.0 

func (v *CreateAgentScheduleInput) GetEnabled() *bool

GetEnabled returns CreateAgentScheduleInput.Enabled, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetEntryNodeUrn added in v0.6.0 

func (v *CreateAgentScheduleInput) GetEntryNodeUrn() string

GetEntryNodeUrn returns CreateAgentScheduleInput.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetEventData added in v0.6.0 

func (v *CreateAgentScheduleInput) GetEventData() *json.RawMessage

GetEventData returns CreateAgentScheduleInput.EventData, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetName added in v0.6.0 

func (v *CreateAgentScheduleInput) GetName() string

GetName returns CreateAgentScheduleInput.Name, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetPolicy added in v0.6.0 

func (v *CreateAgentScheduleInput) GetPolicy() *json.RawMessage

GetPolicy returns CreateAgentScheduleInput.Policy, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetRunAsSelf added in v0.6.0 

func (v *CreateAgentScheduleInput) GetRunAsSelf() *bool

GetRunAsSelf returns CreateAgentScheduleInput.RunAsSelf, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetRunAt added in v0.7.0 

func (v *CreateAgentScheduleInput) GetRunAt() *string

GetRunAt returns CreateAgentScheduleInput.RunAt, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetScopeRef added in v0.14.0 

func (v *CreateAgentScheduleInput) GetScopeRef() *string

GetScopeRef returns CreateAgentScheduleInput.ScopeRef, and is useful for accessing the field via an interface.

func (*CreateAgentScheduleInput) GetTimezone added in v0.6.0 

func (v *CreateAgentScheduleInput) GetTimezone() *string

GetTimezone returns CreateAgentScheduleInput.Timezone, and is useful for accessing the field via an interface.

type CreateAgentScheduleResponse added in v0.6.0 

type CreateAgentScheduleResponse struct {
	CreateAgentSchedule *CreateAgentScheduleCreateAgentSchedule `json:"createAgentSchedule"`
}

CreateAgentScheduleResponse is returned by CreateAgentSchedule on success.

func CreateAgentSchedule added in v0.6.0 

func CreateAgentSchedule(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateAgentScheduleInput,
) (data_ *CreateAgentScheduleResponse, err_ error)

func (*CreateAgentScheduleResponse) GetCreateAgentSchedule added in v0.6.0 

func (v *CreateAgentScheduleResponse) GetCreateAgentSchedule() *CreateAgentScheduleCreateAgentSchedule

GetCreateAgentSchedule returns CreateAgentScheduleResponse.CreateAgentSchedule, and is useful for accessing the field via an interface.

type CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials added in v0.6.0 

type CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials struct {
	AgentWebhookCredentialFields `json:"-"`
}

CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials includes the requested fields of the GraphQL type AgentWebhookCredentials. The GraphQL type's documentation follows.

Create/rotate result — path + platform token are shown ONCE.

func (*CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) GetPath added in v0.6.0 

func (v *CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) GetPath() string

GetPath returns CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials.Path, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) GetToken added in v0.6.0 

func (v *CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) GetToken() string

GetToken returns CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials.Token, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) GetWebhook added in v0.6.0 

func (v *CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) GetWebhook() *AgentWebhookCredentialFieldsWebhookAgentWebhook

GetWebhook returns CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials.Webhook, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) MarshalJSON added in v0.6.0 

func (v *CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) MarshalJSON() ([]byte, error)

func (*CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) UnmarshalJSON added in v0.6.0 

func (v *CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials) UnmarshalJSON(b []byte) error

type CreateAgentWebhookInput added in v0.6.0 

type CreateAgentWebhookInput struct {
	// Agent — ref: PK or URN; must be installed in the App.
	AgentRef     *string `json:"agentRef,omitempty"`
	AiConfigName *string `json:"aiConfigName,omitempty"`
	// App — ref: PK or fully-qualified URN.
	AppRef string `json:"appRef"`
	// JSON Schema for POST args (stored in v1; enforcement is follow-on).
	ArgsSchema   *json.RawMessage `json:"argsSchema,omitempty"`
	Enabled      *bool            `json:"enabled,omitempty"`
	EntryNodeUrn string           `json:"entryNodeUrn"`
	EventData    *json.RawMessage `json:"eventData,omitempty"`
	// Lowercase alphanumeric/dash, 1-64 chars — part of the URL.
	Name      string           `json:"name"`
	Policy    *json.RawMessage `json:"policy,omitempty"`
	RunAsSelf *bool            `json:"runAsSelf,omitempty"`
	// Spec 049 (D-2026-09-13-004): the scope this webhook's runs carry — a scope id, or a name resolved in the App's context. Snapshotted onto each run at mint; omitted ⇒ 'app'.
	ScopeRef *string `json:"scopeRef,omitempty"`
}

func (*CreateAgentWebhookInput) GetAgentRef added in v0.7.0 

func (v *CreateAgentWebhookInput) GetAgentRef() *string

GetAgentRef returns CreateAgentWebhookInput.AgentRef, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetAiConfigName added in v0.6.0 

func (v *CreateAgentWebhookInput) GetAiConfigName() *string

GetAiConfigName returns CreateAgentWebhookInput.AiConfigName, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetAppRef added in v0.7.0 

func (v *CreateAgentWebhookInput) GetAppRef() string

GetAppRef returns CreateAgentWebhookInput.AppRef, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetArgsSchema added in v0.6.0 

func (v *CreateAgentWebhookInput) GetArgsSchema() *json.RawMessage

GetArgsSchema returns CreateAgentWebhookInput.ArgsSchema, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetEnabled added in v0.6.0 

func (v *CreateAgentWebhookInput) GetEnabled() *bool

GetEnabled returns CreateAgentWebhookInput.Enabled, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetEntryNodeUrn added in v0.6.0 

func (v *CreateAgentWebhookInput) GetEntryNodeUrn() string

GetEntryNodeUrn returns CreateAgentWebhookInput.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetEventData added in v0.6.0 

func (v *CreateAgentWebhookInput) GetEventData() *json.RawMessage

GetEventData returns CreateAgentWebhookInput.EventData, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetName added in v0.6.0 

func (v *CreateAgentWebhookInput) GetName() string

GetName returns CreateAgentWebhookInput.Name, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetPolicy added in v0.6.0 

func (v *CreateAgentWebhookInput) GetPolicy() *json.RawMessage

GetPolicy returns CreateAgentWebhookInput.Policy, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetRunAsSelf added in v0.6.0 

func (v *CreateAgentWebhookInput) GetRunAsSelf() *bool

GetRunAsSelf returns CreateAgentWebhookInput.RunAsSelf, and is useful for accessing the field via an interface.

func (*CreateAgentWebhookInput) GetScopeRef added in v0.14.0 

func (v *CreateAgentWebhookInput) GetScopeRef() *string

GetScopeRef returns CreateAgentWebhookInput.ScopeRef, and is useful for accessing the field via an interface.

type CreateAgentWebhookResponse added in v0.6.0 

type CreateAgentWebhookResponse struct {
	// Create a webhook trigger — returns the URL path + platform token ONCE (D-2026-05-02).
	CreateAgentWebhook *CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials `json:"createAgentWebhook"`
}

CreateAgentWebhookResponse is returned by CreateAgentWebhook on success.

func CreateAgentWebhook added in v0.6.0 

func CreateAgentWebhook(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateAgentWebhookInput,
) (data_ *CreateAgentWebhookResponse, err_ error)

func (*CreateAgentWebhookResponse) GetCreateAgentWebhook added in v0.6.0 

func (v *CreateAgentWebhookResponse) GetCreateAgentWebhook() *CreateAgentWebhookCreateAgentWebhookAgentWebhookCredentials

GetCreateAgentWebhook returns CreateAgentWebhookResponse.CreateAgentWebhook, and is useful for accessing the field via an interface.

type CreateAiServiceConfigCreateAiServiceConfig added in v0.3.0 

type CreateAiServiceConfigCreateAiServiceConfig struct {
	AiServiceConfigFields `json:"-"`
}

CreateAiServiceConfigCreateAiServiceConfig includes the requested fields of the GraphQL type AiServiceConfig. The GraphQL type's documentation follows.

036-ai-service-config: a named AI service configuration (masked management view — never carries key material beyond the preview). Owned by exactly one of HadronServer / Organization / App / Agent. Resolution walks App -> Agent -> Org (of the App) -> HadronServer and returns the first ENABLED config with the requested name. Well-known fallback name: 'default' (conventional extras: 'fast', 'frontier'). Name is unique per owner.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetApiKeyPreview added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetApiKeyPreview() *string

GetApiKeyPreview returns CreateAiServiceConfigCreateAiServiceConfig.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetCreatedAt added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetCreatedAt() string

GetCreatedAt returns CreateAiServiceConfigCreateAiServiceConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetEnabled added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetEnabled() bool

GetEnabled returns CreateAiServiceConfigCreateAiServiceConfig.Enabled, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetHasApiKey added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetHasApiKey() bool

GetHasApiKey returns CreateAiServiceConfigCreateAiServiceConfig.HasApiKey, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetId added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetId() string

GetId returns CreateAiServiceConfigCreateAiServiceConfig.Id, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetModel added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetModel() string

GetModel returns CreateAiServiceConfigCreateAiServiceConfig.Model, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetName added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetName() string

GetName returns CreateAiServiceConfigCreateAiServiceConfig.Name, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetOwnerId added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetOwnerId() string

GetOwnerId returns CreateAiServiceConfigCreateAiServiceConfig.OwnerId, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetOwnerType added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetOwnerType() AiConfigOwnerType

GetOwnerType returns CreateAiServiceConfigCreateAiServiceConfig.OwnerType, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetParams added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetParams() *json.RawMessage

GetParams returns CreateAiServiceConfigCreateAiServiceConfig.Params, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetProvider added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetProvider() string

GetProvider returns CreateAiServiceConfigCreateAiServiceConfig.Provider, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) GetUpdatedAt added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) GetUpdatedAt() *string

GetUpdatedAt returns CreateAiServiceConfigCreateAiServiceConfig.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigCreateAiServiceConfig) MarshalJSON added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) MarshalJSON() ([]byte, error)

func (*CreateAiServiceConfigCreateAiServiceConfig) UnmarshalJSON added in v0.3.0 

func (v *CreateAiServiceConfigCreateAiServiceConfig) UnmarshalJSON(b []byte) error

type CreateAiServiceConfigResponse added in v0.3.0 

type CreateAiServiceConfigResponse struct {
	// 036-ai-service-config: create a named AI config on an owner entity.
	//
	// apiKey semantics: non-empty = encrypted at rest with a masked preview.
	// Omitted is accepted only where a run may use the server's own
	// credential: a HADRON_SERVER config for openai, anthropic or bedrock at
	// their default host (no endpoint). Every ORGANIZATION, APP and AGENT
	// config needs its own key: the platform credential is platform spend
	// (#1390). Any other provider (glm, openai-compatible), and any config
	// with an endpoint, needs one too, because the SDK would otherwise send
	// the server's credential to a host that didn't issue it (#1389). All of
	// these are refused with AiConfigValidationError. A host that checks no
	// key takes any placeholder.
	// Name must be 1-64 lower-case [a-z0-9_-], unique per
	// owner. provider must be a known provider; params are validated per
	// provider.
	//
	// Auth: as aiServiceConfigs. ownerId accepts ID or URN
	// (HADRON_SERVER: ID only).
	CreateAiServiceConfig *CreateAiServiceConfigCreateAiServiceConfig `json:"createAiServiceConfig"`
}

CreateAiServiceConfigResponse is returned by CreateAiServiceConfig on success.

func CreateAiServiceConfig added in v0.3.0 

func CreateAiServiceConfig(
	ctx_ context.Context,
	client_ graphql.Client,
	name string,
	provider string,
	model string,
	ownerId string,
	ownerType AiConfigOwnerType,
	apiKey *string,
	enabled *bool,
	params *json.RawMessage,
) (data_ *CreateAiServiceConfigResponse, err_ error)

apiKey: omitted (nil) = stored without a key; non-empty = encrypted at rest. omitempty here is nil-based, so a non-nil &false is still sent — only a nil pointer is dropped.

func (*CreateAiServiceConfigResponse) GetCreateAiServiceConfig added in v0.3.0 

func (v *CreateAiServiceConfigResponse) GetCreateAiServiceConfig() *CreateAiServiceConfigCreateAiServiceConfig

GetCreateAiServiceConfig returns CreateAiServiceConfigResponse.CreateAiServiceConfig, and is useful for accessing the field via an interface.

type CreateAiServiceConfigWithEndpointCreateAiServiceConfig added in v0.18.0 

type CreateAiServiceConfigWithEndpointCreateAiServiceConfig struct {
	AiServiceConfigEndpointFields `json:"-"`
}

CreateAiServiceConfigWithEndpointCreateAiServiceConfig includes the requested fields of the GraphQL type AiServiceConfig. The GraphQL type's documentation follows.

036-ai-service-config: a named AI service configuration (masked management view — never carries key material beyond the preview). Owned by exactly one of HadronServer / Organization / App / Agent. Resolution walks App -> Agent -> Org (of the App) -> HadronServer and returns the first ENABLED config with the requested name. Well-known fallback name: 'default' (conventional extras: 'fast', 'frontier'). Name is unique per owner.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetApiKeyPreview added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetApiKeyPreview() *string

GetApiKeyPreview returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetCreatedAt added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetCreatedAt() string

GetCreatedAt returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetEffectiveEndpoint added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetEffectiveEndpoint() *string

GetEffectiveEndpoint returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.EffectiveEndpoint, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetEnabled added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetEnabled() bool

GetEnabled returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.Enabled, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetEndpoint added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetEndpoint() *string

GetEndpoint returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.Endpoint, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetHasApiKey added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetHasApiKey() bool

GetHasApiKey returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.HasApiKey, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetId added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetId() string

GetId returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.Id, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetModel added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetModel() string

GetModel returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.Model, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetName added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetName() string

GetName returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.Name, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetOwnerId added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetOwnerId() string

GetOwnerId returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.OwnerId, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetOwnerType added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetOwnerType() AiConfigOwnerType

GetOwnerType returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.OwnerType, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetParams added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetParams() *json.RawMessage

GetParams returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.Params, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetProvider added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetProvider() string

GetProvider returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.Provider, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetUpdatedAt added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) GetUpdatedAt() *string

GetUpdatedAt returns CreateAiServiceConfigWithEndpointCreateAiServiceConfig.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) MarshalJSON added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) MarshalJSON() ([]byte, error)

func (*CreateAiServiceConfigWithEndpointCreateAiServiceConfig) UnmarshalJSON added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointCreateAiServiceConfig) UnmarshalJSON(b []byte) error

type CreateAiServiceConfigWithEndpointResponse added in v0.18.0 

type CreateAiServiceConfigWithEndpointResponse struct {
	// 036-ai-service-config: create a named AI config on an owner entity.
	//
	// apiKey semantics: non-empty = encrypted at rest with a masked preview.
	// Omitted is accepted only where a run may use the server's own
	// credential: a HADRON_SERVER config for openai, anthropic or bedrock at
	// their default host (no endpoint). Every ORGANIZATION, APP and AGENT
	// config needs its own key: the platform credential is platform spend
	// (#1390). Any other provider (glm, openai-compatible), and any config
	// with an endpoint, needs one too, because the SDK would otherwise send
	// the server's credential to a host that didn't issue it (#1389). All of
	// these are refused with AiConfigValidationError. A host that checks no
	// key takes any placeholder.
	// Name must be 1-64 lower-case [a-z0-9_-], unique per
	// owner. provider must be a known provider; params are validated per
	// provider.
	//
	// Auth: as aiServiceConfigs. ownerId accepts ID or URN
	// (HADRON_SERVER: ID only).
	CreateAiServiceConfig *CreateAiServiceConfigWithEndpointCreateAiServiceConfig `json:"createAiServiceConfig"`
}

CreateAiServiceConfigWithEndpointResponse is returned by CreateAiServiceConfigWithEndpoint on success.

func CreateAiServiceConfigWithEndpoint added in v0.18.0 

func CreateAiServiceConfigWithEndpoint(
	ctx_ context.Context,
	client_ graphql.Client,
	name string,
	provider string,
	model string,
	ownerId string,
	ownerType AiConfigOwnerType,
	apiKey *string,
	enabled *bool,
	params *json.RawMessage,
	endpoint *string,
) (data_ *CreateAiServiceConfigWithEndpointResponse, err_ error)

func (*CreateAiServiceConfigWithEndpointResponse) GetCreateAiServiceConfig added in v0.18.0 

func (v *CreateAiServiceConfigWithEndpointResponse) GetCreateAiServiceConfig() *CreateAiServiceConfigWithEndpointCreateAiServiceConfig

GetCreateAiServiceConfig returns CreateAiServiceConfigWithEndpointResponse.CreateAiServiceConfig, and is useful for accessing the field via an interface.

type CreateAppCreateApp 

type CreateAppCreateApp struct {
	Id      string  `json:"id"`
	Urn     string  `json:"urn"`
	Name    string  `json:"name"`
	AppType AppType `json:"appType"`
	// SOFT-DEPRECATED convenience read: the FIRST installed Agent. An App
	// installs MANY Agents through the `AppAgent` join (023-app-shape Phase 2b,
	// which DROPPED the direct FK that 008-agent-installation had introduced) —
	// see `appAgents` below for the real cardinality. Kept so single-Agent
	// clients keep working; do not build new multi-Agent logic on it.
	AgentId     *string `json:"agentId"`
	MemberCount int     `json:"memberCount"`
	CreatedAt   string  `json:"createdAt"`
}

CreateAppCreateApp includes the requested fields of the GraphQL type App. The GraphQL type's documentation follows.

A runtime caller identity owned by exactly one Organization or User. It owns long-lived App Keys and installs Agents through the AppAgent N:M join: one App may install many Agents, and one Agent may be installed in many Apps. The singular agentId / agent fields below are soft-deprecated convenience reads of the first install, not a direct foreign key.

func (*CreateAppCreateApp) GetAgentId 

func (v *CreateAppCreateApp) GetAgentId() *string

GetAgentId returns CreateAppCreateApp.AgentId, and is useful for accessing the field via an interface.

func (*CreateAppCreateApp) GetAppType 

func (v *CreateAppCreateApp) GetAppType() AppType

GetAppType returns CreateAppCreateApp.AppType, and is useful for accessing the field via an interface.

func (*CreateAppCreateApp) GetCreatedAt 

func (v *CreateAppCreateApp) GetCreatedAt() string

GetCreatedAt returns CreateAppCreateApp.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateAppCreateApp) GetId 

func (v *CreateAppCreateApp) GetId() string

GetId returns CreateAppCreateApp.Id, and is useful for accessing the field via an interface.

func (*CreateAppCreateApp) GetMemberCount 

func (v *CreateAppCreateApp) GetMemberCount() int

GetMemberCount returns CreateAppCreateApp.MemberCount, and is useful for accessing the field via an interface.

func (*CreateAppCreateApp) GetName 

func (v *CreateAppCreateApp) GetName() string

GetName returns CreateAppCreateApp.Name, and is useful for accessing the field via an interface.

func (*CreateAppCreateApp) GetUrn 

func (v *CreateAppCreateApp) GetUrn() string

GetUrn returns CreateAppCreateApp.Urn, and is useful for accessing the field via an interface.

type CreateAppResponse 

type CreateAppResponse struct {
	// Create an App and install its initial Agent. With orgRef, the App is owned
	// by that Organization and requires org ADMIN; without orgRef, it is owned by
	// the authenticated User and remains owner-only.
	//
	// An org-owned install auto-provisions an AgentOrgGrant only for its own
	// Agent. A cross-org install requires an existing active grant; subscribe to
	// a PUBLIC Agent through createAgentOrgGrant before creating the App.
	// It adds the caller as an AppMember with role 'owner' only when that role is
	// present in the Agent's installationPolicy and the caller is a User.
	// Required AgentImports cascade automatically for org-owned Apps; optional
	// imports cascade only when their id appears in installOptional. Personal
	// Apps reject dependency cascades in v1.
	//
	// Selected dependencies must also be licensed before any App is created.
	// The server enforces this even when a caller bypasses the portal.
	//
	// Accepts the entity's ID or URN.
	CreateApp *CreateAppCreateApp `json:"createApp"`
}

CreateAppResponse is returned by CreateApp on success.

func CreateApp 

func CreateApp(
	ctx_ context.Context,
	client_ graphql.Client,
	orgRef *string,
	agentRef string,
	name string,
	urn *string,
	appType *AppType,
	description *string,
) (data_ *CreateAppResponse, err_ error)

func (*CreateAppResponse) GetCreateApp 

func (v *CreateAppResponse) GetCreateApp() *CreateAppCreateApp

GetCreateApp returns CreateAppResponse.CreateApp, and is useful for accessing the field via an interface.

type CreateAssetReferenceNodeCreateAssetReferenceNode added in v0.9.0 

type CreateAssetReferenceNodeCreateAssetReferenceNode struct {
	Id string `json:"id"`
	// Fully-qualified node URN (hrn:node:<root>:<memory>:<loc>), composed server-side from the node's memory URN + loc (#481). Carried by every Node-returning surface (findNodes, node, appNodes, nodeBatch, mutation returns).
	Urn  string `json:"urn"`
	Loc  string `json:"loc"`
	Name string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string `json:"nodeType"`
	MemoryId string `json:"memoryId"`
}

CreateAssetReferenceNodeCreateAssetReferenceNode includes the requested fields of the GraphQL type Node.

func (*CreateAssetReferenceNodeCreateAssetReferenceNode) GetId added in v0.9.0 

func (v *CreateAssetReferenceNodeCreateAssetReferenceNode) GetId() string

GetId returns CreateAssetReferenceNodeCreateAssetReferenceNode.Id, and is useful for accessing the field via an interface.

func (*CreateAssetReferenceNodeCreateAssetReferenceNode) GetLoc added in v0.9.0 

func (v *CreateAssetReferenceNodeCreateAssetReferenceNode) GetLoc() string

GetLoc returns CreateAssetReferenceNodeCreateAssetReferenceNode.Loc, and is useful for accessing the field via an interface.

func (*CreateAssetReferenceNodeCreateAssetReferenceNode) GetMemoryId added in v0.9.0 

func (v *CreateAssetReferenceNodeCreateAssetReferenceNode) GetMemoryId() string

GetMemoryId returns CreateAssetReferenceNodeCreateAssetReferenceNode.MemoryId, and is useful for accessing the field via an interface.

func (*CreateAssetReferenceNodeCreateAssetReferenceNode) GetName added in v0.9.0 

func (v *CreateAssetReferenceNodeCreateAssetReferenceNode) GetName() string

GetName returns CreateAssetReferenceNodeCreateAssetReferenceNode.Name, and is useful for accessing the field via an interface.

func (*CreateAssetReferenceNodeCreateAssetReferenceNode) GetNodeType added in v0.9.0 

func (v *CreateAssetReferenceNodeCreateAssetReferenceNode) GetNodeType() string

GetNodeType returns CreateAssetReferenceNodeCreateAssetReferenceNode.NodeType, and is useful for accessing the field via an interface.

func (*CreateAssetReferenceNodeCreateAssetReferenceNode) GetUrn added in v0.9.0 

func (v *CreateAssetReferenceNodeCreateAssetReferenceNode) GetUrn() string

GetUrn returns CreateAssetReferenceNodeCreateAssetReferenceNode.Urn, and is useful for accessing the field via an interface.

type CreateAssetReferenceNodeResponse added in v0.9.0 

type CreateAssetReferenceNodeResponse struct {
	CreateAssetReferenceNode *CreateAssetReferenceNodeCreateAssetReferenceNode `json:"createAssetReferenceNode"`
}

CreateAssetReferenceNodeResponse is returned by CreateAssetReferenceNode on success.

func CreateAssetReferenceNode added in v0.9.0 

func CreateAssetReferenceNode(
	ctx_ context.Context,
	client_ graphql.Client,
	assetRef string,
	nodeUrn string,
	name *string,
	description *string,
) (data_ *CreateAssetReferenceNodeResponse, err_ error)

Attach an asset to the graph as a nodeType:reference node whose data.asset points at it — the same shape hadron_store_file writes, so a reader handles both origins identically. There is no schema-level Asset→Node link (cor:dmo:060:10 reserves it); this is a soft reference, and Node.asset resolves to null once the asset is gone.

func (*CreateAssetReferenceNodeResponse) GetCreateAssetReferenceNode added in v0.9.0 

func (v *CreateAssetReferenceNodeResponse) GetCreateAssetReferenceNode() *CreateAssetReferenceNodeCreateAssetReferenceNode

GetCreateAssetReferenceNode returns CreateAssetReferenceNodeResponse.CreateAssetReferenceNode, and is useful for accessing the field via an interface.

type CreateChannelCreateChannel added in v0.14.0 

type CreateChannelCreateChannel struct {
	ChannelFields `json:"-"`
	ChannelMemory `json:"-"`
}

CreateChannelCreateChannel includes the requested fields of the GraphQL type Channel. The GraphQL type's documentation follows.

A CHANNEL (spec 049, D-2026-09-13-006): a durable, ordered message stream hosted in ONE memory at ONE reserved address, server-ordered and server-attributed — a platform entity, created one-to-one with its chat root. Creating it RESERVES and PROTECTS the address: generic node writes under it are refused (LOC_PROTECTED); its own operations (createTeamChatMessage, hadron_team_chat_post) are the only writers. The audience is the host memory's (cor:acl:030:01) — a Channel has no access layer of its own. `lastSeq` / `lastMessageAt` are the platform-maintained watermark.

func (*CreateChannelCreateChannel) GetChatRootNodeId added in v0.14.0 

func (v *CreateChannelCreateChannel) GetChatRootNodeId() string

GetChatRootNodeId returns CreateChannelCreateChannel.ChatRootNodeId, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetChatRootUrn added in v0.14.0 

func (v *CreateChannelCreateChannel) GetChatRootUrn() *string

GetChatRootUrn returns CreateChannelCreateChannel.ChatRootUrn, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetCreatedAt added in v0.14.0 

func (v *CreateChannelCreateChannel) GetCreatedAt() string

GetCreatedAt returns CreateChannelCreateChannel.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetDescription added in v0.14.0 

func (v *CreateChannelCreateChannel) GetDescription() *string

GetDescription returns CreateChannelCreateChannel.Description, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetId added in v0.14.0 

func (v *CreateChannelCreateChannel) GetId() string

GetId returns CreateChannelCreateChannel.Id, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetKind added in v0.14.0 

func (v *CreateChannelCreateChannel) GetKind() ChannelKind

GetKind returns CreateChannelCreateChannel.Kind, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetLastMessageAt added in v0.14.0 

func (v *CreateChannelCreateChannel) GetLastMessageAt() *string

GetLastMessageAt returns CreateChannelCreateChannel.LastMessageAt, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetLastSeq added in v0.14.0 

func (v *CreateChannelCreateChannel) GetLastSeq() int

GetLastSeq returns CreateChannelCreateChannel.LastSeq, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetLoc added in v0.14.0 

func (v *CreateChannelCreateChannel) GetLoc() string

GetLoc returns CreateChannelCreateChannel.Loc, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetMemory added in v0.14.0 

func (v *CreateChannelCreateChannel) GetMemory() *ChannelMemoryMemory

GetMemory returns CreateChannelCreateChannel.Memory, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetMemoryId added in v0.14.0 

func (v *CreateChannelCreateChannel) GetMemoryId() string

GetMemoryId returns CreateChannelCreateChannel.MemoryId, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetName added in v0.14.0 

func (v *CreateChannelCreateChannel) GetName() string

GetName returns CreateChannelCreateChannel.Name, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) GetUpdatedAt added in v0.14.0 

func (v *CreateChannelCreateChannel) GetUpdatedAt() *string

GetUpdatedAt returns CreateChannelCreateChannel.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateChannelCreateChannel) MarshalJSON added in v0.14.0 

func (v *CreateChannelCreateChannel) MarshalJSON() ([]byte, error)

func (*CreateChannelCreateChannel) UnmarshalJSON added in v0.14.0 

func (v *CreateChannelCreateChannel) UnmarshalJSON(b []byte) error

type CreateChannelInput added in v0.14.0 

type CreateChannelInput struct {
	Description *string `json:"description,omitempty"`
	Loc         string  `json:"loc"`
	MemoryRef   string  `json:"memoryRef"`
	Name        string  `json:"name"`
}

Create a named Channel WITH its chat root, in one transaction. The host may be a memory of ANY class that you may write — the host memory's own audience decides who reads and posts (cor:acl:030:01), so a Channel in a private memory is private and one in an app memory is the App's. `loc` is the reserved address (e.g. chats:release) and must not overlap an existing Channel's; `chats:team` is every App's default and is created with the App.

There is no app-class precondition. This said there was until #1248 — the rule was retired by #1196 and the description outlived it, so every client mirroring this SDL published a refusal that cannot fire.

**Creating at a DELETED Channel's address starts CLEAN** (#1226). The address stays reserved by the tombstone, so a create here adopts it rather than inserting beside it — and the previous Channel's messages are tombstoned so the new room is empty. The allocator history remains, while the empty Channel's last-sequence and last-message watermarks reset. Its first new message therefore resumes above the old maximum, so an old read cursor cannot hide it. Expect a gap in the numbering, never inherited transcript or phantom attention.

func (*CreateChannelInput) GetDescription added in v0.14.0 

func (v *CreateChannelInput) GetDescription() *string

GetDescription returns CreateChannelInput.Description, and is useful for accessing the field via an interface.

func (*CreateChannelInput) GetLoc added in v0.14.0 

func (v *CreateChannelInput) GetLoc() string

GetLoc returns CreateChannelInput.Loc, and is useful for accessing the field via an interface.

func (*CreateChannelInput) GetMemoryRef added in v0.14.0 

func (v *CreateChannelInput) GetMemoryRef() string

GetMemoryRef returns CreateChannelInput.MemoryRef, and is useful for accessing the field via an interface.

func (*CreateChannelInput) GetName added in v0.14.0 

func (v *CreateChannelInput) GetName() string

GetName returns CreateChannelInput.Name, and is useful for accessing the field via an interface.

type CreateChannelMessageCreateChannelMessageTeamChatMessage added in v0.14.0 

type CreateChannelMessageCreateChannelMessageTeamChatMessage struct {
	ChannelMessageFields `json:"-"`
}

CreateChannelMessageCreateChannelMessageTeamChatMessage includes the requested fields of the GraphQL type TeamChatMessage. The GraphQL type's documentation follows.

One message in a team App's chat (#939, Worker envelope since #974). Exactly one of authorUserId / authorWorkerId is set: a human post carries the user, a worker post carries the Worker (the named casting, cor:dmo:050:11) plus the driving sessionId. mentions holds the lowercased tokens extracted server-side at write time (the '@worker-name / @handle' format, stored without the '@').

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAt added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAt() string

GetAt returns CreateChannelMessageCreateChannelMessageTeamChatMessage.At, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorAppId added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorAppId() *string

GetAuthorAppId returns CreateChannelMessageCreateChannelMessageTeamChatMessage.AuthorAppId, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorName added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorName() *string

GetAuthorName returns CreateChannelMessageCreateChannelMessageTeamChatMessage.AuthorName, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorUserId added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorUserId() *string

GetAuthorUserId returns CreateChannelMessageCreateChannelMessageTeamChatMessage.AuthorUserId, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorWorkerId added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetAuthorWorkerId() *string

GetAuthorWorkerId returns CreateChannelMessageCreateChannelMessageTeamChatMessage.AuthorWorkerId, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetBody added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetBody() string

GetBody returns CreateChannelMessageCreateChannelMessageTeamChatMessage.Body, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetMentions added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetMentions() []string

GetMentions returns CreateChannelMessageCreateChannelMessageTeamChatMessage.Mentions, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetNodeId added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetNodeId() string

GetNodeId returns CreateChannelMessageCreateChannelMessageTeamChatMessage.NodeId, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetReplyToSeq added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetReplyToSeq() *int

GetReplyToSeq returns CreateChannelMessageCreateChannelMessageTeamChatMessage.ReplyToSeq, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetSeq added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetSeq() int

GetSeq returns CreateChannelMessageCreateChannelMessageTeamChatMessage.Seq, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) GetSessionId added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) GetSessionId() *string

GetSessionId returns CreateChannelMessageCreateChannelMessageTeamChatMessage.SessionId, and is useful for accessing the field via an interface.

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) MarshalJSON added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) MarshalJSON() ([]byte, error)

func (*CreateChannelMessageCreateChannelMessageTeamChatMessage) UnmarshalJSON added in v0.14.0 

func (v *CreateChannelMessageCreateChannelMessageTeamChatMessage) UnmarshalJSON(b []byte) error

type CreateChannelMessageResponse added in v0.14.0 

type CreateChannelMessageResponse struct {
	// Spec 049 Phase 8 — post into ANY Channel by ref (its id, or its address —
	// `Channel.chatRootUrn`, #1171): the
	// createTeamChatMessage contract (author derivation, mentions, replyToSeq,
	// the body cap, item J) addressed by Channel. createTeamChatMessage is the
	// appRef → App.defaultChannel convenience over this — one gate, two entry
	// points. A Channel you may not read is CHANNEL_NOT_FOUND; one you may read
	// but not post into is FORBIDDEN.
	CreateChannelMessage *CreateChannelMessageCreateChannelMessageTeamChatMessage `json:"createChannelMessage"`
}

CreateChannelMessageResponse is returned by CreateChannelMessage on success.

func CreateChannelMessage added in v0.14.0 

func CreateChannelMessage(
	ctx_ context.Context,
	client_ graphql.Client,
	channelRef string,
	body string,
	replyToSeq *int,
	sessionRef *string,
) (data_ *CreateChannelMessageResponse, err_ error)

Post into a Channel.

sessionRef is what makes the message the WORKER's rather than the human's. It is optional on the wire, and that is the quiet failure the team-chat tools are known for: omitting it posts as the caller, with no error and the wrong authorship recorded. The command surfaces that rather than defaulting it silently.

func (*CreateChannelMessageResponse) GetCreateChannelMessage added in v0.14.0 

func (v *CreateChannelMessageResponse) GetCreateChannelMessage() *CreateChannelMessageCreateChannelMessageTeamChatMessage

GetCreateChannelMessage returns CreateChannelMessageResponse.CreateChannelMessage, and is useful for accessing the field via an interface.

type CreateChannelResponse added in v0.14.0 

type CreateChannelResponse struct {
	// Spec 049 Phase 4 — create a named Channel with its chat root. The host is
	// any memory class you may write; its audience decides the Channel's
	// (cor:acl:030:01). LOC_OVERLAPS_CHANNEL when the address overlaps an
	// existing Channel's.
	CreateChannel *CreateChannelCreateChannel `json:"createChannel"`
}

CreateChannelResponse is returned by CreateChannel on success.

func CreateChannel added in v0.14.0 

func CreateChannel(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateChannelInput,
) (data_ *CreateChannelResponse, err_ error)

Create a Channel on a host memory at a reserved loc. The (memoryRef, loc) pair IS the address the other operations accept back, which is why `chatRootUrn` exists to emit it rather than asking a caller to rebuild it.

func (*CreateChannelResponse) GetCreateChannel added in v0.14.0 

func (v *CreateChannelResponse) GetCreateChannel() *CreateChannelCreateChannel

GetCreateChannel returns CreateChannelResponse.CreateChannel, and is useful for accessing the field via an interface.

type CreateConnectionGrantCreateConnectionGrant added in v0.7.0 

type CreateConnectionGrantCreateConnectionGrant struct {
	ConnectionGrantFields `json:"-"`
}

CreateConnectionGrantCreateConnectionGrant includes the requested fields of the GraphQL type ConnectionGrant. The GraphQL type's documentation follows.

A user-owned connection's scoped delegation to an App install (spec-042 Track B, #593). The connection OWNER grants a specific App scoped access to their mailbox/calendar; the enforcement gate is requireEmailConnection. The grantee App is exposed as SCALARS only (never a nested App object), so a cross-org grant can't reach the App keys/members. Token material is never exposed.

func (*CreateConnectionGrantCreateConnectionGrant) GetConnectionId added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetConnectionId() string

GetConnectionId returns CreateConnectionGrantCreateConnectionGrant.ConnectionId, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) GetCreatedAt added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetCreatedAt() string

GetCreatedAt returns CreateConnectionGrantCreateConnectionGrant.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) GetExpiresAt added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetExpiresAt() *string

GetExpiresAt returns CreateConnectionGrantCreateConnectionGrant.ExpiresAt, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) GetGranteeAppId added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetGranteeAppId() string

GetGranteeAppId returns CreateConnectionGrantCreateConnectionGrant.GranteeAppId, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) GetGranteeAppName added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetGranteeAppName() *string

GetGranteeAppName returns CreateConnectionGrantCreateConnectionGrant.GranteeAppName, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) GetGranteeAppUrn added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetGranteeAppUrn() *string

GetGranteeAppUrn returns CreateConnectionGrantCreateConnectionGrant.GranteeAppUrn, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) GetId added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetId() string

GetId returns CreateConnectionGrantCreateConnectionGrant.Id, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) GetScopes added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) GetScopes() []string

GetScopes returns CreateConnectionGrantCreateConnectionGrant.Scopes, and is useful for accessing the field via an interface.

func (*CreateConnectionGrantCreateConnectionGrant) MarshalJSON added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) MarshalJSON() ([]byte, error)

func (*CreateConnectionGrantCreateConnectionGrant) UnmarshalJSON added in v0.7.0 

func (v *CreateConnectionGrantCreateConnectionGrant) UnmarshalJSON(b []byte) error

type CreateConnectionGrantResponse added in v0.7.0 

type CreateConnectionGrantResponse struct {
	// Grant an App install scoped access to a connection you OWN. scopes must be a
	// subset of {mail.read, mail.send, calendar.freebusy, calendar.read, drive.read};
	// expiresAt (ISO-8601) is optional and must be in the future. appRef is a PK or
	// App URN.
	CreateConnectionGrant *CreateConnectionGrantCreateConnectionGrant `json:"createConnectionGrant"`
}

CreateConnectionGrantResponse is returned by CreateConnectionGrant on success.

func CreateConnectionGrant added in v0.7.0 

func CreateConnectionGrant(
	ctx_ context.Context,
	client_ graphql.Client,
	connectionRef string,
	appRef string,
	scopes []string,
	expiresAt *string,
) (data_ *CreateConnectionGrantResponse, err_ error)

appRef accepts a PK or an App URN; expiresAt is optional ISO-8601 (future).

func (*CreateConnectionGrantResponse) GetCreateConnectionGrant added in v0.7.0 

func (v *CreateConnectionGrantResponse) GetCreateConnectionGrant() *CreateConnectionGrantCreateConnectionGrant

GetCreateConnectionGrant returns CreateConnectionGrantResponse.CreateConnectionGrant, and is useful for accessing the field via an interface.

type CreateEdgeCreateEdge 

type CreateEdgeCreateEdge struct {
	Id string `json:"id"`
	// Free-form relationship name (e.g. imports, depends_on). Optional since
	// spec 037 — loc is the identity. (Was the required 'label'.)
	Name *string `json:"name"`
	// Colon-delimited path within the (source node's) memory — the edge's
	// identity and the suffix of its URN hrn:edge:<root>:<memory>:<loc>.
	Loc string `json:"loc"`
	// If true, this edge can be executed/run (task automation, conversation
	// transitions). Mirrors Node.isRunnable.
	IsRunnable *bool `json:"isRunnable"`
	// Resolution-order hook (lower = earlier; default 0). When two edges
	// share a priority, fall back to insertion order.
	Priority int `json:"priority"`
	// The source node. NULLABLE (#781): null when the caller cannot read the source node's memory — a cross-memory edge (e.g. reached via incomingEdges) must not expose an endpoint in a memory the caller can't read. For a same-memory edge the caller can already see, this is always present.
	Source *CreateEdgeCreateEdgeSourceNode `json:"source"`
	// The target node. NULLABLE (#781): null when the caller cannot read the target node's memory (a cross-memory edge's far endpoint). For a same-memory edge, always present.
	Target *CreateEdgeCreateEdgeTargetNode `json:"target"`
}

CreateEdgeCreateEdge includes the requested fields of the GraphQL type Edge.

func (*CreateEdgeCreateEdge) GetId 

func (v *CreateEdgeCreateEdge) GetId() string

GetId returns CreateEdgeCreateEdge.Id, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdge) GetIsRunnable added in v0.3.0 

func (v *CreateEdgeCreateEdge) GetIsRunnable() *bool

GetIsRunnable returns CreateEdgeCreateEdge.IsRunnable, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdge) GetLoc added in v0.3.0 

func (v *CreateEdgeCreateEdge) GetLoc() string

GetLoc returns CreateEdgeCreateEdge.Loc, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdge) GetName added in v0.3.0 

func (v *CreateEdgeCreateEdge) GetName() *string

GetName returns CreateEdgeCreateEdge.Name, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdge) GetPriority 

func (v *CreateEdgeCreateEdge) GetPriority() int

GetPriority returns CreateEdgeCreateEdge.Priority, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdge) GetSource 

func (v *CreateEdgeCreateEdge) GetSource() *CreateEdgeCreateEdgeSourceNode

GetSource returns CreateEdgeCreateEdge.Source, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdge) GetTarget 

func (v *CreateEdgeCreateEdge) GetTarget() *CreateEdgeCreateEdgeTargetNode

GetTarget returns CreateEdgeCreateEdge.Target, and is useful for accessing the field via an interface.

type CreateEdgeCreateEdgeSourceNode 

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

CreateEdgeCreateEdgeSourceNode includes the requested fields of the GraphQL type Node.

func (*CreateEdgeCreateEdgeSourceNode) GetId 

func (v *CreateEdgeCreateEdgeSourceNode) GetId() string

GetId returns CreateEdgeCreateEdgeSourceNode.Id, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdgeSourceNode) GetLoc 

func (v *CreateEdgeCreateEdgeSourceNode) GetLoc() string

GetLoc returns CreateEdgeCreateEdgeSourceNode.Loc, and is useful for accessing the field via an interface.

type CreateEdgeCreateEdgeTargetNode 

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

CreateEdgeCreateEdgeTargetNode includes the requested fields of the GraphQL type Node.

func (*CreateEdgeCreateEdgeTargetNode) GetId 

func (v *CreateEdgeCreateEdgeTargetNode) GetId() string

GetId returns CreateEdgeCreateEdgeTargetNode.Id, and is useful for accessing the field via an interface.

func (*CreateEdgeCreateEdgeTargetNode) GetLoc 

func (v *CreateEdgeCreateEdgeTargetNode) GetLoc() string

GetLoc returns CreateEdgeCreateEdgeTargetNode.Loc, and is useful for accessing the field via an interface.

type CreateEdgeResponse 

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

CreateEdgeResponse is returned by CreateEdge on success.

func CreateEdge 

func CreateEdge(
	ctx_ context.Context,
	client_ graphql.Client,
	sourceRef string,
	targetRef string,
	name string,
	loc *string,
	description *string,
	isRunnable *bool,
	priority *int,
	condition *json.RawMessage,
	data *json.RawMessage,
) (data_ *CreateEdgeResponse, err_ error)

Unset optional variables must be omitted from the wire, not sent as explicit nulls — the server rejects priority: null (hadron-server#263) and treats condition/data: null as "clear".

func (*CreateEdgeResponse) GetCreateEdge 

func (v *CreateEdgeResponse) GetCreateEdge() *CreateEdgeCreateEdge

GetCreateEdge returns CreateEdgeResponse.CreateEdge, and is useful for accessing the field via an interface.

type CreateMcpServerCreateMcpServer added in v0.7.0 

type CreateMcpServerCreateMcpServer struct {
	McpServerFields `json:"-"`
}

CreateMcpServerCreateMcpServer includes the requested fields of the GraphQL type McpServer. The GraphQL type's documentation follows.

One registered EXTERNAL MCP server (hadrontool-mcp conduit registry). Org-owned. Static auth headers are encrypted at rest and WRITE-ONLY: no field here ever returns them — hasHeaders is all a reader gets. The row grants nothing by itself; every run-time call walks the policy chain as 'tool.mcp__<slug>__<tool>' plus the run's action budget.

func (*CreateMcpServerCreateMcpServer) GetCreatedAt added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetCreatedAt() string

GetCreatedAt returns CreateMcpServerCreateMcpServer.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetEnabled added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetEnabled() bool

GetEnabled returns CreateMcpServerCreateMcpServer.Enabled, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetHasHeaders added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetHasHeaders() bool

GetHasHeaders returns CreateMcpServerCreateMcpServer.HasHeaders, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetId added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetId() string

GetId returns CreateMcpServerCreateMcpServer.Id, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetName added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetName() string

GetName returns CreateMcpServerCreateMcpServer.Name, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetOrganizationId added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetOrganizationId() string

GetOrganizationId returns CreateMcpServerCreateMcpServer.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetSlug added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetSlug() string

GetSlug returns CreateMcpServerCreateMcpServer.Slug, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetToolAllowlist added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetToolAllowlist() []string

GetToolAllowlist returns CreateMcpServerCreateMcpServer.ToolAllowlist, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetUpdatedAt added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetUpdatedAt() string

GetUpdatedAt returns CreateMcpServerCreateMcpServer.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) GetUrl added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) GetUrl() string

GetUrl returns CreateMcpServerCreateMcpServer.Url, and is useful for accessing the field via an interface.

func (*CreateMcpServerCreateMcpServer) MarshalJSON added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) MarshalJSON() ([]byte, error)

func (*CreateMcpServerCreateMcpServer) UnmarshalJSON added in v0.7.0 

func (v *CreateMcpServerCreateMcpServer) UnmarshalJSON(b []byte) error

type CreateMcpServerResponse added in v0.7.0 

type CreateMcpServerResponse struct {
	// Register an external MCP server (org ADMIN/OWNER). orgRef accepts ID
	// or URN (cor:api:140). headers is a JSON object of static request
	// headers (e.g. Authorization) — encrypted at rest, write-only, never
	// returned. Registration grants nothing by itself: runs still need the
	// policy chain to allow tool.mcp__<slug>__<tool>.
	CreateMcpServer *CreateMcpServerCreateMcpServer `json:"createMcpServer"`
}

CreateMcpServerResponse is returned by CreateMcpServer on success.

func CreateMcpServer added in v0.7.0 

func CreateMcpServer(
	ctx_ context.Context,
	client_ graphql.Client,
	orgRef string,
	slug string,
	name string,
	url string,
	headers *json.RawMessage,
	toolAllowlist *[]string,
	enabled *bool,
) (data_ *CreateMcpServerResponse, err_ error)

headers is a write-only JSON object; toolAllowlist empty/omitted = all tools.

func (*CreateMcpServerResponse) GetCreateMcpServer added in v0.7.0 

func (v *CreateMcpServerResponse) GetCreateMcpServer() *CreateMcpServerCreateMcpServer

GetCreateMcpServer returns CreateMcpServerResponse.CreateMcpServer, and is useful for accessing the field via an interface.

type CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload added in v0.18.0 

type CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload struct {
	Template *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate `json:"template"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning `json:"warnings"`
}

CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload includes the requested fields of the GraphQL type MemoryConfigTemplatePayload.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload) GetTemplate added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload) GetTemplate() *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate

GetTemplate returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload.Template, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload) GetWarnings added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload) GetWarnings() []*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning

GetWarnings returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload.Warnings, and is useful for accessing the field via an interface.

type CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate added in v0.18.0 

type CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate struct {
	MemoryConfigTemplateFields `json:"-"`
}

CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate includes the requested fields of the GraphQL type MemoryConfigTemplate. The GraphQL type's documentation follows.

#1325 part (c) — a reusable rulebook with exactly one owner, COPIED into a memory's config when applied (never live-linked). Read and managed only by its owner's managers: a platform admin (server), an org ADMIN/OWNER (organization), the user themselves (user), the App's owner or org ADMIN/OWNER (App). For anyone else it does not exist.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedAt added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedAt() string

GetCreatedAt returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedBy added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedBy() *string

GetCreatedBy returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.CreatedBy, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetDescription added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetDescription() *string

GetDescription returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Description, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetId added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetId() string

GetId returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Id, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetName added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetName() string

GetName returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Name, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerId added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerId() *string

GetOwnerId returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.OwnerId, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerType added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerType() MemoryConfigTemplateOwnerType

GetOwnerType returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.OwnerType, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRequired added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRequired() bool

GetRequired returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Required, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRevision added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRevision() int

GetRevision returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Revision, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRules added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRules() []*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule

GetRules returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Rules, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedAt added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedAt() *string

GetUpdatedAt returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedBy added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedBy() *string

GetUpdatedBy returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.UpdatedBy, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) MarshalJSON added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) MarshalJSON() ([]byte, error)

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) UnmarshalJSON added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) UnmarshalJSON(b []byte) error

type CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning added in v0.18.0 

type CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetCode added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetCode() string

GetCode returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetField added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetField() *string

GetField returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetRole added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetRole() string

GetRole returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskState added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskUrn added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) MarshalJSON added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) UnmarshalJSON added in v0.18.0 

func (v *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type CreateMemoryConfigTemplateInput added in v0.18.0 

type CreateMemoryConfigTemplateInput struct {
	Description *string `json:"description,omitempty"`
	Name        string  `json:"name"`
	Required    *bool   `json:"required,omitempty"`
	// Each role at most once (NODE_ROLE_RULE_EXISTS).
	Rules []*CreateNodeRoleRuleInput `json:"rules,omitempty"`
}

#1325 part (c) — a new template. `rules` are validated as a whole before anything is written.

func (*CreateMemoryConfigTemplateInput) GetDescription added in v0.18.0 

func (v *CreateMemoryConfigTemplateInput) GetDescription() *string

GetDescription returns CreateMemoryConfigTemplateInput.Description, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateInput) GetName added in v0.18.0 

func (v *CreateMemoryConfigTemplateInput) GetName() string

GetName returns CreateMemoryConfigTemplateInput.Name, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateInput) GetRequired added in v0.18.0 

func (v *CreateMemoryConfigTemplateInput) GetRequired() *bool

GetRequired returns CreateMemoryConfigTemplateInput.Required, and is useful for accessing the field via an interface.

func (*CreateMemoryConfigTemplateInput) GetRules added in v0.18.0 

func (v *CreateMemoryConfigTemplateInput) GetRules() []*CreateNodeRoleRuleInput

GetRules returns CreateMemoryConfigTemplateInput.Rules, and is useful for accessing the field via an interface.

type CreateMemoryConfigTemplateResponse added in v0.18.0 

type CreateMemoryConfigTemplateResponse struct {
	// #1325 part (c) — create a template. ownerRef names the organization, user
	// or App; omit it for HADRON_SERVER (platform admins only; refused
	// HADRON_SERVER_NOT_CONFIGURED when this server has no row) and for USER
	// (yourself — you own templates for no one else). A second live template of
	// the same name under the same owner is MEMORY_CONFIG_TEMPLATE_EXISTS.
	CreateMemoryConfigTemplate *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload `json:"createMemoryConfigTemplate"`
}

CreateMemoryConfigTemplateResponse is returned by CreateMemoryConfigTemplate on success.

func CreateMemoryConfigTemplate added in v0.18.0 

func CreateMemoryConfigTemplate(
	ctx_ context.Context,
	client_ graphql.Client,
	ownerType MemoryConfigTemplateOwnerType,
	ownerRef *string,
	input *CreateMemoryConfigTemplateInput,
) (data_ *CreateMemoryConfigTemplateResponse, err_ error)

ownerRef is OMITTED for HADRON_SERVER and for USER (yourself); a given one must name the owner.

func (*CreateMemoryConfigTemplateResponse) GetCreateMemoryConfigTemplate added in v0.18.0 

func (v *CreateMemoryConfigTemplateResponse) GetCreateMemoryConfigTemplate() *CreateMemoryConfigTemplateCreateMemoryConfigTemplateMemoryConfigTemplatePayload

GetCreateMemoryConfigTemplate returns CreateMemoryConfigTemplateResponse.CreateMemoryConfigTemplate, and is useful for accessing the field via an interface.

type CreateMemoryCreateMemory 

type CreateMemoryCreateMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

CreateMemoryCreateMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*CreateMemoryCreateMemory) GetClass 

func (v *CreateMemoryCreateMemory) GetClass() MemoryClass

GetClass returns CreateMemoryCreateMemory.Class, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetId 

func (v *CreateMemoryCreateMemory) GetId() string

GetId returns CreateMemoryCreateMemory.Id, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetIsEncrypted 

func (v *CreateMemoryCreateMemory) GetIsEncrypted() bool

GetIsEncrypted returns CreateMemoryCreateMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetMaxRevCount added in v0.7.0 

func (v *CreateMemoryCreateMemory) GetMaxRevCount() int

GetMaxRevCount returns CreateMemoryCreateMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetName 

func (v *CreateMemoryCreateMemory) GetName() string

GetName returns CreateMemoryCreateMemory.Name, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetOrganizationId 

func (v *CreateMemoryCreateMemory) GetOrganizationId() *string

GetOrganizationId returns CreateMemoryCreateMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetShortDescription 

func (v *CreateMemoryCreateMemory) GetShortDescription() *string

GetShortDescription returns CreateMemoryCreateMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetUpdatedAt 

func (v *CreateMemoryCreateMemory) GetUpdatedAt() string

GetUpdatedAt returns CreateMemoryCreateMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetUrn 

func (v *CreateMemoryCreateMemory) GetUrn() string

GetUrn returns CreateMemoryCreateMemory.Urn, and is useful for accessing the field via an interface.

func (*CreateMemoryCreateMemory) GetVisibility 

func (v *CreateMemoryCreateMemory) GetVisibility() *MemoryVisibility

GetVisibility returns CreateMemoryCreateMemory.Visibility, and is useful for accessing the field via an interface.

type CreateMemoryDraftCreateMemory added in v0.18.0 

type CreateMemoryDraftCreateMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

CreateMemoryDraftCreateMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*CreateMemoryDraftCreateMemory) GetClass added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetClass() MemoryClass

GetClass returns CreateMemoryDraftCreateMemory.Class, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetId added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetId() string

GetId returns CreateMemoryDraftCreateMemory.Id, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetIsEncrypted added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetIsEncrypted() bool

GetIsEncrypted returns CreateMemoryDraftCreateMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetMaxRevCount added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetMaxRevCount() int

GetMaxRevCount returns CreateMemoryDraftCreateMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetName added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetName() string

GetName returns CreateMemoryDraftCreateMemory.Name, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetOrganizationId added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetOrganizationId() *string

GetOrganizationId returns CreateMemoryDraftCreateMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetShortDescription added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetShortDescription() *string

GetShortDescription returns CreateMemoryDraftCreateMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetUpdatedAt added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetUpdatedAt() string

GetUpdatedAt returns CreateMemoryDraftCreateMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetUrn added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetUrn() string

GetUrn returns CreateMemoryDraftCreateMemory.Urn, and is useful for accessing the field via an interface.

func (*CreateMemoryDraftCreateMemory) GetVisibility added in v0.18.0 

func (v *CreateMemoryDraftCreateMemory) GetVisibility() *MemoryVisibility

GetVisibility returns CreateMemoryDraftCreateMemory.Visibility, and is useful for accessing the field via an interface.

type CreateMemoryDraftResponse added in v0.18.0 

type CreateMemoryDraftResponse 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 *CreateMemoryDraftCreateMemory `json:"createMemory"`
}

CreateMemoryDraftResponse is returned by CreateMemoryDraft on success.

func CreateMemoryDraft added in v0.18.0 

func CreateMemoryDraft(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId *string,
	name string,
	memoryClass *MemoryClass,
	shortDescription *string,
	description *string,
	tags *[]string,
	visibility *MemoryVisibility,
	maxRevCount *int,
) (data_ *CreateMemoryDraftResponse, err_ error)

Keep the ordinary CreateMemory document free of draftCorpus. GraphQL validates the full document before execution, so omitting a variable value does not make an unknown argument compatible with a pre-#1447 server.

func (*CreateMemoryDraftResponse) GetCreateMemory added in v0.18.0 

func (v *CreateMemoryDraftResponse) GetCreateMemory() *CreateMemoryDraftCreateMemory

GetCreateMemory returns CreateMemoryDraftResponse.CreateMemory, and is useful for accessing the field via an interface.

type CreateMemoryInAppCreateMemoryInAppMemory added in v0.7.0 

type CreateMemoryInAppCreateMemoryInAppMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

CreateMemoryInAppCreateMemoryInAppMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetClass added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetClass() MemoryClass

GetClass returns CreateMemoryInAppCreateMemoryInAppMemory.Class, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetId added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetId() string

GetId returns CreateMemoryInAppCreateMemoryInAppMemory.Id, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetIsEncrypted added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetIsEncrypted() bool

GetIsEncrypted returns CreateMemoryInAppCreateMemoryInAppMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetMaxRevCount added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetMaxRevCount() int

GetMaxRevCount returns CreateMemoryInAppCreateMemoryInAppMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetName added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetName() string

GetName returns CreateMemoryInAppCreateMemoryInAppMemory.Name, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetOrganizationId added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetOrganizationId() *string

GetOrganizationId returns CreateMemoryInAppCreateMemoryInAppMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetShortDescription added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetShortDescription() *string

GetShortDescription returns CreateMemoryInAppCreateMemoryInAppMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetUpdatedAt added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetUpdatedAt() string

GetUpdatedAt returns CreateMemoryInAppCreateMemoryInAppMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetUrn added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetUrn() string

GetUrn returns CreateMemoryInAppCreateMemoryInAppMemory.Urn, and is useful for accessing the field via an interface.

func (*CreateMemoryInAppCreateMemoryInAppMemory) GetVisibility added in v0.7.0 

func (v *CreateMemoryInAppCreateMemoryInAppMemory) GetVisibility() *MemoryVisibility

GetVisibility returns CreateMemoryInAppCreateMemoryInAppMemory.Visibility, and is useful for accessing the field via an interface.

type CreateMemoryInAppResponse added in v0.7.0 

type CreateMemoryInAppResponse struct {
	// Add a NEW memory to an App, born App-scoped.
	//
	// Unlike createMemory (which only makes free-standing memories), this scopes
	// the new memory to an App. memoryClass accepts only the App-associable
	// classes: 'app', 'personal', or 'private' ('system'/'knowledge'/'group'
	// forbid an app_id). appRef/agentRef accept an ID, bare URN, or prefixed URN;
	// the Agent must be installed in the App.
	//
	// Authorization is split by class: 'app' is shared deployment data and
	// requires org OWNER/ADMIN; 'personal'/'private' are the caller's OWN memory
	// and require only App membership (the caller becomes the owner).
	//
	// Typed errors: UNSUPPORTED_MEMORY_CLASS, BAD_USER_INPUT (maxRevCount < 1),
	// APP_UNINSTALLED, AGENT_NOT_INSTALLED, MEMORY_URN_CONFLICT, FORBIDDEN,
	// UNAUTHENTICATED.
	CreateMemoryInApp *CreateMemoryInAppCreateMemoryInAppMemory `json:"createMemoryInApp"`
}

CreateMemoryInAppResponse is returned by CreateMemoryInApp on success.

func CreateMemoryInApp added in v0.7.0 

func CreateMemoryInApp(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	agentRef string,
	memoryClass MemoryClass,
	name string,
	shortDescription *string,
	description *string,
	tags *[]string,
	maxRevCount *int,
) (data_ *CreateMemoryInAppResponse, err_ error)

Create a new App-scoped app/personal/private memory. The server owns URN composition: app-class URNs are name-derived; personal/private use opaque per-owner identities, so this mutation intentionally has no slug argument.

func (*CreateMemoryInAppResponse) GetCreateMemoryInApp added in v0.7.0 

func (v *CreateMemoryInAppResponse) GetCreateMemoryInApp() *CreateMemoryInAppCreateMemoryInAppMemory

GetCreateMemoryInApp returns CreateMemoryInAppResponse.CreateMemoryInApp, and is useful for accessing the field via an interface.

type CreateMemoryResponse 

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"`
}

CreateMemoryResponse is returned by CreateMemory on success.

func CreateMemory 

func CreateMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId *string,
	name string,
	memoryClass *MemoryClass,
	shortDescription *string,
	description *string,
	tags *[]string,
	visibility *MemoryVisibility,
	maxRevCount *int,
) (data_ *CreateMemoryResponse, err_ error)

func (*CreateMemoryResponse) GetCreateMemory 

func (v *CreateMemoryResponse) GetCreateMemory() *CreateMemoryCreateMemory

GetCreateMemory returns CreateMemoryResponse.CreateMemory, and is useful for accessing the field via an interface.

type CreateMemoryShareCreateMemoryShareCreateMemorySharePayload added in v0.3.0 

type CreateMemoryShareCreateMemoryShareCreateMemorySharePayload struct {
	MemoryShare *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare `json:"memoryShare"`
}

CreateMemoryShareCreateMemoryShareCreateMemorySharePayload includes the requested fields of the GraphQL type CreateMemorySharePayload.

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayload) GetMemoryShare added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayload) GetMemoryShare() *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare

GetMemoryShare returns CreateMemoryShareCreateMemoryShareCreateMemorySharePayload.MemoryShare, and is useful for accessing the field via an interface.

type CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare added in v0.3.0 

type CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare struct {
	Role MemoryShareRole `json:"role"`
	// The User who was granted access.
	Grantee *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser `json:"grantee"`
}

CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare includes the requested fields of the GraphQL type MemoryShare. The GraphQL type's documentation follows.

023-app-shape US3: asymmetric cross-user grant on a personal-class Memory. The principal (memory.userId) grants a grantee read/write access. Used for per-pairing isolation patterns (e.g., Alice's personal Memory paired-with-Mentor-A is distinct from her paired-with-Mentor-B Memory, each with its own MemoryShare).

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare) GetGrantee added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare) GetGrantee() *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser

GetGrantee returns CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare.Grantee, and is useful for accessing the field via an interface.

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare) GetRole added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare) GetRole() MemoryShareRole

GetRole returns CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShare.Role, and is useful for accessing the field via an interface.

type CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser added in v0.3.0 

type CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser struct {
	MemUserFields `json:"-"`
}

CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser includes the requested fields of the GraphQL type User.

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetEmail added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetEmail() *string

GetEmail returns CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser.Email, and is useful for accessing the field via an interface.

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetHandle added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetHandle() *string

GetHandle returns CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser.Handle, and is useful for accessing the field via an interface.

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetId added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetId() string

GetId returns CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser.Id, and is useful for accessing the field via an interface.

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetName added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) GetName() *string

GetName returns CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser.Name, and is useful for accessing the field via an interface.

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) MarshalJSON added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) MarshalJSON() ([]byte, error)

func (*CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) UnmarshalJSON added in v0.3.0 

func (v *CreateMemoryShareCreateMemoryShareCreateMemorySharePayloadMemoryShareGranteeUser) UnmarshalJSON(b []byte) error

type CreateMemoryShareResponse added in v0.3.0 

type CreateMemoryShareResponse struct {
	// 023-app-shape US3 — asymmetric cross-user grant on a personal-class
	// Memory. The principal (memory.userId) grants a grantee read or
	// write access. Used for the per-pairing pattern (Alice's
	// paired-with-Mentor-A memory is distinct from her
	// paired-with-Mentor-B memory; each gets its own MemoryShare).
	//
	// Upsert semantics: re-calling with a different role on an existing
	// (memoryId, granteeId) pair updates the role rather than throwing.
	//
	// For v1 the caller MUST be the principal themselves (memory.userId
	// === ctx.userId). The Agent-mediated path (App backend acting on
	// the principal's behalf via MCP) is supported by the access-control
	// predicate but not by this GraphQL surface — see the deferred
	// policy discussion linked from joinApp.ts.
	//
	// Share-audience rule (#778): a plain ORG-OWNED personal memory
	// (organizationId set, no agent scope) may be shared ONLY with a
	// current member of that org; a FREE-STANDING (org-less) personal
	// memory may be shared with any user. Agent-scoped personal memories
	// (the spec-023 per-pairing App pattern) are exempt — their audience
	// is governed by AppMember + AgentSubscription, not org membership.
	//
	// Error codes (extensions.code, Error.name style):
	// - UNAUTHENTICATED — no logged-in user in context.
	// - FORBIDDEN — caller is not the Memory's principal. The
	// caller-authority guard runs first and deliberately does not
	// differentiate between "memory doesn't exist", "memory is not
	// personal-class", and "caller isn't the principal" — all three
	// return FORBIDDEN so memory metadata isn't leaked to
	// non-principals.
	// - MemoryShareGranteeMissingError — granteeId doesn't resolve to
	// an existing User. Only reachable when the caller passes the
	// principal guard.
	// - CrossOrgShareNotAllowedError — the grantee is not a member of an
	// org-owned personal memory's org (the #778 audience rule above).
	// - InvalidMemoryClassForShareError / MemoryNotFoundForShareError —
	// defined on the controller for completeness; functionally
	// unreachable via this GraphQL mutation in v1 because the
	// caller-authority guard short-circuits to FORBIDDEN first.
	CreateMemoryShare *CreateMemoryShareCreateMemoryShareCreateMemorySharePayload `json:"createMemoryShare"`
}

CreateMemoryShareResponse is returned by CreateMemoryShare on success.

func CreateMemoryShare added in v0.3.0 

func CreateMemoryShare(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryId string,
	granteeRef string,
	role MemoryShareRole,
) (data_ *CreateMemoryShareResponse, err_ error)

#769/#304: granteeRef is server-resolved (id / email / handle / hrn:user URN) — resolution sees the full user table, so a cross-org share by email works without a client-side lookup. createMemoryShare has no memoryRef arg (the memory is still passed as the client-resolved id via memoryId).

func (*CreateMemoryShareResponse) GetCreateMemoryShare added in v0.3.0 

func (v *CreateMemoryShareResponse) GetCreateMemoryShare() *CreateMemoryShareCreateMemoryShareCreateMemorySharePayload

GetCreateMemoryShare returns CreateMemoryShareResponse.CreateMemoryShare, and is useful for accessing the field via an interface.

type CreateMemorySubscriptionCreateMemorySubscription added in v0.7.0 

type CreateMemorySubscriptionCreateMemorySubscription struct {
	Role      Role `json:"role"`
	Activated bool `json:"activated"`
	// The subscriber Organization when the caller may read it; memory access alone does not authorize it.
	Organization *CreateMemorySubscriptionCreateMemorySubscriptionOrganization `json:"organization"`
}

CreateMemorySubscriptionCreateMemorySubscription includes the requested fields of the GraphQL type MemorySubscription. The GraphQL type's documentation follows.

An organization's subscription to a memory it does not own.

func (*CreateMemorySubscriptionCreateMemorySubscription) GetActivated added in v0.7.0 

func (v *CreateMemorySubscriptionCreateMemorySubscription) GetActivated() bool

GetActivated returns CreateMemorySubscriptionCreateMemorySubscription.Activated, and is useful for accessing the field via an interface.

func (*CreateMemorySubscriptionCreateMemorySubscription) GetOrganization added in v0.7.0 

func (v *CreateMemorySubscriptionCreateMemorySubscription) GetOrganization() *CreateMemorySubscriptionCreateMemorySubscriptionOrganization

GetOrganization returns CreateMemorySubscriptionCreateMemorySubscription.Organization, and is useful for accessing the field via an interface.

func (*CreateMemorySubscriptionCreateMemorySubscription) GetRole added in v0.7.0 

func (v *CreateMemorySubscriptionCreateMemorySubscription) GetRole() Role

GetRole returns CreateMemorySubscriptionCreateMemorySubscription.Role, and is useful for accessing the field via an interface.

type CreateMemorySubscriptionCreateMemorySubscriptionOrganization added in v0.7.0 

type CreateMemorySubscriptionCreateMemorySubscriptionOrganization struct {
	Id   string `json:"id"`
	Name string `json:"name"`
	Urn  string `json:"urn"`
}

CreateMemorySubscriptionCreateMemorySubscriptionOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*CreateMemorySubscriptionCreateMemorySubscriptionOrganization) GetId added in v0.7.0 

func (v *CreateMemorySubscriptionCreateMemorySubscriptionOrganization) GetId() string

GetId returns CreateMemorySubscriptionCreateMemorySubscriptionOrganization.Id, and is useful for accessing the field via an interface.

func (*CreateMemorySubscriptionCreateMemorySubscriptionOrganization) GetName added in v0.7.0 

func (v *CreateMemorySubscriptionCreateMemorySubscriptionOrganization) GetName() string

GetName returns CreateMemorySubscriptionCreateMemorySubscriptionOrganization.Name, and is useful for accessing the field via an interface.

func (*CreateMemorySubscriptionCreateMemorySubscriptionOrganization) GetUrn added in v0.7.0 

func (v *CreateMemorySubscriptionCreateMemorySubscriptionOrganization) GetUrn() string

GetUrn returns CreateMemorySubscriptionCreateMemorySubscriptionOrganization.Urn, and is useful for accessing the field via an interface.

type CreateMemorySubscriptionResponse added in v0.7.0 

type CreateMemorySubscriptionResponse struct {
	// Create a cross-org Memory subscription.
	//
	// Accepts the entity's ID or URN.
	CreateMemorySubscription *CreateMemorySubscriptionCreateMemorySubscription `json:"createMemorySubscription"`
}

CreateMemorySubscriptionResponse is returned by CreateMemorySubscription on success.

func CreateMemorySubscription added in v0.7.0 

func CreateMemorySubscription(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	orgRef string,
	role Role,
) (data_ *CreateMemorySubscriptionResponse, err_ error)

#764/#304: orgRef is server-resolved (id / slug / hrn:org URN); the CLI passes the raw --org value. memoryRef receives the client-resolved memory id.

func (*CreateMemorySubscriptionResponse) GetCreateMemorySubscription added in v0.7.0 

func (v *CreateMemorySubscriptionResponse) GetCreateMemorySubscription() *CreateMemorySubscriptionCreateMemorySubscription

GetCreateMemorySubscription returns CreateMemorySubscriptionResponse.CreateMemorySubscription, and is useful for accessing the field via an interface.

type CreateNodeCreateNode added in v0.5.1 

type CreateNodeCreateNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

CreateNodeCreateNode includes the requested fields of the GraphQL type Node.

func (*CreateNodeCreateNode) GetId added in v0.5.1 

func (v *CreateNodeCreateNode) GetId() string

GetId returns CreateNodeCreateNode.Id, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetIsRunnable added in v0.5.1 

func (v *CreateNodeCreateNode) GetIsRunnable() *bool

GetIsRunnable returns CreateNodeCreateNode.IsRunnable, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetLoc added in v0.5.1 

func (v *CreateNodeCreateNode) GetLoc() string

GetLoc returns CreateNodeCreateNode.Loc, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetMemoryId added in v0.5.1 

func (v *CreateNodeCreateNode) GetMemoryId() string

GetMemoryId returns CreateNodeCreateNode.MemoryId, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetName added in v0.5.1 

func (v *CreateNodeCreateNode) GetName() string

GetName returns CreateNodeCreateNode.Name, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetNodeType added in v0.5.1 

func (v *CreateNodeCreateNode) GetNodeType() string

GetNodeType returns CreateNodeCreateNode.NodeType, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetRole added in v0.15.0 

func (v *CreateNodeCreateNode) GetRole() *string

GetRole returns CreateNodeCreateNode.Role, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetSeq added in v0.7.0 

func (v *CreateNodeCreateNode) GetSeq() *int

GetSeq returns CreateNodeCreateNode.Seq, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetTags added in v0.5.1 

func (v *CreateNodeCreateNode) GetTags() []string

GetTags returns CreateNodeCreateNode.Tags, and is useful for accessing the field via an interface.

func (*CreateNodeCreateNode) GetUpdatedAt added in v0.5.1 

func (v *CreateNodeCreateNode) GetUpdatedAt() string

GetUpdatedAt returns CreateNodeCreateNode.UpdatedAt, and is useful for accessing the field via an interface.

type CreateNodeInput added in v0.5.1 

type CreateNodeInput struct {
	// Paragraph-length summary of this node — see Node.abstract for the surfacing contract. Optional. 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"`
	// MIME type of content (#476/#488, spec cor:cnv:010:01): 'text/markdown' (default) stores as-is; 'text/html' converts captured DOM to Markdown; 'application/pdf' extracts a PDF's text layer to Markdown (send 'content' as raw base64 — a PDF is binary; scanned/image-only PDFs error). The conversion runs before storage and fills properties.title from the extracted title when not supplied. Consumed at write time — never persisted. Any other value is rejected.
	ContentType *string          `json:"contentType,omitempty"`
	Data        *json.RawMessage `json:"data,omitempty"`
	Description *string          `json:"description,omitempty"`
	// Outgoing edges to create with the node.
	Edges []*NodeEdgeInput `json:"edges,omitempty"`
	// Forced PK (importer/sync use case, e.g. a stable UUIDv7). Only ever a create-id here — never a selector (D2). Omit to mint.
	Id *string `json:"id,omitempty"`
	// Whether this node can be run as a task by hadron_run_task (cor:api:060).
	IsRunnable *bool   `json:"isRunnable,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"`
	// #725 — collection discriminator (e.g. "competitor" / "insight"). NULL for an ordinary node.
	ObjectType *string          `json:"objectType,omitempty"`
	OwnerRepo  *string          `json:"ownerRepo,omitempty"`
	Properties *json.RawMessage `json:"properties,omitempty"`
	// Recorded on revision history only when a soft-deleted node is resurrected (a pure create snapshots nothing).
	Reason *string `json:"reason,omitempty"`
	// #1201 — what this node is FOR (open string). NOT 'nodeType' (the
	// platform-kind axis) and NOT 'objectType' (the collection discriminator).
	// A GOVERNED value ('review', 'spec') requires that kind's own door; the
	// generic createNode refuses it.
	Role *string  `json:"role,omitempty"`
	Seq  *int     `json:"seq,omitempty"`
	Tags []string `json:"tags,omitempty"`
}

Input for createNode. 'memoryId', 'loc', and 'name' are required; creating is create-only — a live node at (memoryId, loc) rejects with NodeLocConflictError (spec 039 Phase 0 D1/D4).

func (*CreateNodeInput) GetAbstract added in v0.5.1 

func (v *CreateNodeInput) GetAbstract() *string

GetAbstract returns CreateNodeInput.Abstract, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetAiAgent added in v0.5.1 

func (v *CreateNodeInput) GetAiAgent() *string

GetAiAgent returns CreateNodeInput.AiAgent, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetAlias added in v0.5.1 

func (v *CreateNodeInput) GetAlias() *string

GetAlias returns CreateNodeInput.Alias, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetContent added in v0.5.1 

func (v *CreateNodeInput) GetContent() *string

GetContent returns CreateNodeInput.Content, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetContentType added in v0.6.0 

func (v *CreateNodeInput) GetContentType() *string

GetContentType returns CreateNodeInput.ContentType, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetData added in v0.5.1 

func (v *CreateNodeInput) GetData() *json.RawMessage

GetData returns CreateNodeInput.Data, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetDescription added in v0.5.1 

func (v *CreateNodeInput) GetDescription() *string

GetDescription returns CreateNodeInput.Description, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetEdges added in v0.5.1 

func (v *CreateNodeInput) GetEdges() []*NodeEdgeInput

GetEdges returns CreateNodeInput.Edges, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetId added in v0.5.1 

func (v *CreateNodeInput) GetId() *string

GetId returns CreateNodeInput.Id, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetIsRunnable added in v0.5.1 

func (v *CreateNodeInput) GetIsRunnable() *bool

GetIsRunnable returns CreateNodeInput.IsRunnable, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetLlmModel added in v0.5.1 

func (v *CreateNodeInput) GetLlmModel() *string

GetLlmModel returns CreateNodeInput.LlmModel, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetLoc added in v0.5.1 

func (v *CreateNodeInput) GetLoc() string

GetLoc returns CreateNodeInput.Loc, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetMemoryId added in v0.5.1 

func (v *CreateNodeInput) GetMemoryId() string

GetMemoryId returns CreateNodeInput.MemoryId, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetName added in v0.5.1 

func (v *CreateNodeInput) GetName() string

GetName returns CreateNodeInput.Name, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetNodeType added in v0.5.1 

func (v *CreateNodeInput) GetNodeType() *string

GetNodeType returns CreateNodeInput.NodeType, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetObjectType added in v0.8.0 

func (v *CreateNodeInput) GetObjectType() *string

GetObjectType returns CreateNodeInput.ObjectType, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetOwnerRepo added in v0.5.1 

func (v *CreateNodeInput) GetOwnerRepo() *string

GetOwnerRepo returns CreateNodeInput.OwnerRepo, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetProperties added in v0.5.1 

func (v *CreateNodeInput) GetProperties() *json.RawMessage

GetProperties returns CreateNodeInput.Properties, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetReason added in v0.5.1 

func (v *CreateNodeInput) GetReason() *string

GetReason returns CreateNodeInput.Reason, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetRole added in v0.14.0 

func (v *CreateNodeInput) GetRole() *string

GetRole returns CreateNodeInput.Role, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetSeq added in v0.5.1 

func (v *CreateNodeInput) GetSeq() *int

GetSeq returns CreateNodeInput.Seq, and is useful for accessing the field via an interface.

func (*CreateNodeInput) GetTags added in v0.5.1 

func (v *CreateNodeInput) GetTags() []string

GetTags returns CreateNodeInput.Tags, and is useful for accessing the field via an interface.

type CreateNodeResponse added in v0.5.1 

type CreateNodeResponse struct {
	// Create a single node. Rejects with NodeLocConflictError when a live node
	// already exists at (memoryId, loc) — creating is create-only (spec 039
	// Phase 0 D1); a soft-deleted node at the target loc is resurrected.
	// 'name' is required here and only here (D4).
	CreateNode *CreateNodeCreateNode `json:"createNode"`
}

CreateNodeResponse is returned by CreateNode on success.

func CreateNode added in v0.5.1 

func CreateNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateNodeInput,
) (data_ *CreateNodeResponse, err_ error)

Create-only node write (spec 039 Phase 0 — upsertNode is gone). A live node already at (memoryId, loc) rejects with extensions.code NodeLocConflictError. Optional fields the caller leaves unset must be omitted from the wire, not serialized as null — hence the per-field omitempty annotations.

func (*CreateNodeResponse) GetCreateNode added in v0.5.1 

func (v *CreateNodeResponse) GetCreateNode() *CreateNodeCreateNode

GetCreateNode returns CreateNodeResponse.CreateNode, and is useful for accessing the field via an interface.

type CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload added in v0.18.0 

type CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload struct {
	Rule *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule `json:"rule"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning `json:"warnings"`
}

CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload includes the requested fields of the GraphQL type NodeRoleRulePayload.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload) GetRule added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload) GetRule() *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule

GetRule returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload.Rule, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload) GetWarnings added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload) GetWarnings() []*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning

GetWarnings returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload.Warnings, and is useful for accessing the field via an interface.

type CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule added in v0.18.0 

type CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule struct {
	NodeRoleRuleFields `json:"-"`
}

CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule includes the requested fields of the GraphQL type NodeRoleRule. The GraphQL type's documentation follows.

#1325 — one node-role rule. Task and description references are stored by node id (they survive moves) and returned as a URN and an id, each with its state. Both are given only when the state is OK; see NodeRoleRuleRefState.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask() *string

GetAuthorTask returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTask, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId() *string

GetAuthorTaskId returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskId, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskState, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt() string

GetCreatedAt returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy() *string

GetCreatedBy returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedBy, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode() *string

GetDescriptionNode returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNode, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId() *string

GetDescriptionNodeId returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled() bool

GetEnabled returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Enabled, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId() string

GetId returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Id, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked() bool

GetLocked returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Locked, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision() int

GetRevision returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Revision, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole() string

GetRole returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Role, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate() *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate

GetSourceTemplate returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplate, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId() *string

GetSourceTemplateId returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplateId, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles() bool

GetStrictSubRoles returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.StrictSubRoles, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt() *string

GetUpdatedAt returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy() *string

GetUpdatedBy returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedBy, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy() *ContentValidator

GetValidateBy returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidateBy, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask() *string

GetValidationTask returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTask, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId() *string

GetValidationTaskId returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskId, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskState, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters() NodeRoleWriters

GetWriters returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Writers, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON() ([]byte, error)

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON(b []byte) error

type CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning added in v0.18.0 

type CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode() string

GetCode returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField() *string

GetField returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole() string

GetRole returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON added in v0.18.0 

func (v *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type CreateNodeRoleRuleInput added in v0.18.0 

type CreateNodeRoleRuleInput struct {
	AuthorTaskRef      *string `json:"authorTaskRef,omitempty"`
	DescriptionNodeRef *string `json:"descriptionNodeRef,omitempty"`
	Enabled            *bool   `json:"enabled,omitempty"`
	// Lower-case letter/digit/dash segments joined by dots, 1-64 characters (INVALID_NODE_ROLE).
	Role           string `json:"role"`
	StrictSubRoles *bool  `json:"strictSubRoles,omitempty"`
	// Needs a validation task.
	ValidateBy        *ContentValidator `json:"validateBy,omitempty"`
	ValidationTaskRef *string           `json:"validationTaskRef,omitempty"`
	Writers           *NodeRoleWriters  `json:"writers,omitempty"`
}

#1325 — a new rule, in a memory's config or in a template's rule list. Task and description references are node IDs or URNs you can read; a node you cannot read is refused exactly like a missing one (NODE_NOT_FOUND), and a task reference must be a runnable task (NOT_A_TASK).

func (*CreateNodeRoleRuleInput) GetAuthorTaskRef added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetAuthorTaskRef() *string

GetAuthorTaskRef returns CreateNodeRoleRuleInput.AuthorTaskRef, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleInput) GetDescriptionNodeRef added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetDescriptionNodeRef() *string

GetDescriptionNodeRef returns CreateNodeRoleRuleInput.DescriptionNodeRef, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleInput) GetEnabled added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetEnabled() *bool

GetEnabled returns CreateNodeRoleRuleInput.Enabled, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleInput) GetRole added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetRole() string

GetRole returns CreateNodeRoleRuleInput.Role, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleInput) GetStrictSubRoles added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetStrictSubRoles() *bool

GetStrictSubRoles returns CreateNodeRoleRuleInput.StrictSubRoles, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleInput) GetValidateBy added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetValidateBy() *ContentValidator

GetValidateBy returns CreateNodeRoleRuleInput.ValidateBy, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleInput) GetValidationTaskRef added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetValidationTaskRef() *string

GetValidationTaskRef returns CreateNodeRoleRuleInput.ValidationTaskRef, and is useful for accessing the field via an interface.

func (*CreateNodeRoleRuleInput) GetWriters added in v0.18.0 

func (v *CreateNodeRoleRuleInput) GetWriters() *NodeRoleWriters

GetWriters returns CreateNodeRoleRuleInput.Writers, and is useful for accessing the field via an interface.

type CreateNodeRoleRuleResponse added in v0.18.0 

type CreateNodeRoleRuleResponse struct {
	// #1325 — add a rule to a memory's config (creating the config on first use).
	// Managers only; anyone else gets MEMORY_NOT_FOUND. A role that already has a
	// rule is refused NODE_ROLE_RULE_EXISTS.
	CreateNodeRoleRule *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload `json:"createNodeRoleRule"`
}

CreateNodeRoleRuleResponse is returned by CreateNodeRoleRule on success.

func CreateNodeRoleRule added in v0.18.0 

func CreateNodeRoleRule(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	input *CreateNodeRoleRuleInput,
) (data_ *CreateNodeRoleRuleResponse, err_ error)

WIRE SEMANTICS: an OMITTED input field means "not given" (the server default on create, unchanged on update); on update a reference sent as "" CLEARS it. So every optional field carries omitempty, and a nil pointer is never sent as null (CLAUDE.md; findings:null-vs-omitted-args).

The `for:` directives only bind when the variable list is on its own lines (findings:genqlient-for-directive-needs-multiline-signature). Each input type is used by exactly one operation, so no other operation can disagree with these directives and flip the generated tags.

func (*CreateNodeRoleRuleResponse) GetCreateNodeRoleRule added in v0.18.0 

func (v *CreateNodeRoleRuleResponse) GetCreateNodeRoleRule() *CreateNodeRoleRuleCreateNodeRoleRuleNodeRoleRulePayload

GetCreateNodeRoleRule returns CreateNodeRoleRuleResponse.CreateNodeRoleRule, and is useful for accessing the field via an interface.

type CreateObjectResponse added in v0.8.0 

type CreateObjectResponse struct {
	// #745 — Object store: the legible sugar surface over structured storage.
	// An object IS a node; these ops are thin projections onto createNode /
	// updateNodeProperties / deleteNode, inheriting all their invariants
	// (auth, encryption, schema conformance, revisions, atomic merge).
	//
	// Create an object in a collection. 'memoryRef' is a memory ID or
	// fully-qualified URN (relative refs are rejected, spec 022). 'type' is the
	// collection (node objectType); 'fields' are the flat, typed properties
	// (validated against the memory schema when the collection is declared). The
	// node's loc is auto-derived (<type>:<key ?? generated-id>) and hidden; pass
	// 'key' for a human-meaningful id (a single segment, no ':'), 'name' to
	// override the derived node name. 'id' and 'type' are reserved and cannot be
	// field names. Returns the flat object.
	CreateObject json.RawMessage `json:"createObject"`
}

CreateObjectResponse is returned by CreateObject on success.

func CreateObject added in v0.8.0 

func CreateObject(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	objectType string,
	fields json.RawMessage,
	key *string,
	name *string,
) (data_ *CreateObjectResponse, err_ error)

Create an object; returns the flat record. key/name are optional, so a nil pointer must be omitted (not sent as null) — hence the per-var omitempty.

func (*CreateObjectResponse) GetCreateObject added in v0.8.0 

func (v *CreateObjectResponse) GetCreateObject() json.RawMessage

GetCreateObject returns CreateObjectResponse.CreateObject, and is useful for accessing the field via an interface.

type CreateOrganizationCreateOrganization added in v0.3.0 

type CreateOrganizationCreateOrganization struct {
	OrgFields `json:"-"`
}

CreateOrganizationCreateOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*CreateOrganizationCreateOrganization) GetCreatedAt added in v0.3.0 

func (v *CreateOrganizationCreateOrganization) GetCreatedAt() string

GetCreatedAt returns CreateOrganizationCreateOrganization.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateOrganizationCreateOrganization) GetId added in v0.3.0 

func (v *CreateOrganizationCreateOrganization) GetId() string

GetId returns CreateOrganizationCreateOrganization.Id, and is useful for accessing the field via an interface.

func (*CreateOrganizationCreateOrganization) GetListedOnMarketplace added in v0.9.0 

func (v *CreateOrganizationCreateOrganization) GetListedOnMarketplace() bool

GetListedOnMarketplace returns CreateOrganizationCreateOrganization.ListedOnMarketplace, and is useful for accessing the field via an interface.

func (*CreateOrganizationCreateOrganization) GetName added in v0.3.0 

func (v *CreateOrganizationCreateOrganization) GetName() string

GetName returns CreateOrganizationCreateOrganization.Name, and is useful for accessing the field via an interface.

func (*CreateOrganizationCreateOrganization) GetUpdatedAt added in v0.3.0 

func (v *CreateOrganizationCreateOrganization) GetUpdatedAt() string

GetUpdatedAt returns CreateOrganizationCreateOrganization.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateOrganizationCreateOrganization) GetUrn added in v0.3.0 

func (v *CreateOrganizationCreateOrganization) GetUrn() string

GetUrn returns CreateOrganizationCreateOrganization.Urn, and is useful for accessing the field via an interface.

func (*CreateOrganizationCreateOrganization) MarshalJSON added in v0.3.0 

func (v *CreateOrganizationCreateOrganization) MarshalJSON() ([]byte, error)

func (*CreateOrganizationCreateOrganization) UnmarshalJSON added in v0.3.0 

func (v *CreateOrganizationCreateOrganization) UnmarshalJSON(b []byte) error

type CreateOrganizationResponse added in v0.3.0 

type CreateOrganizationResponse struct {
	CreateOrganization *CreateOrganizationCreateOrganization `json:"createOrganization"`
}

CreateOrganizationResponse is returned by CreateOrganization on success.

func CreateOrganization added in v0.3.0 

func CreateOrganization(
	ctx_ context.Context,
	client_ graphql.Client,
	name string,
	urn string,
) (data_ *CreateOrganizationResponse, err_ error)

func (*CreateOrganizationResponse) GetCreateOrganization added in v0.3.0 

func (v *CreateOrganizationResponse) GetCreateOrganization() *CreateOrganizationCreateOrganization

GetCreateOrganization returns CreateOrganizationResponse.CreateOrganization, and is useful for accessing the field via an interface.

type CreatePrincipalGrantCreatePrincipalGrant added in v0.7.0 

type CreatePrincipalGrantCreatePrincipalGrant struct {
	PrincipalGrantFields `json:"-"`
}

CreatePrincipalGrantCreatePrincipalGrant includes the requested fields of the GraphQL type PrincipalGrant. The GraphQL type's documentation follows.

An individual action grant (design:grant-model): extra management actions for one member of one org, on top of their role bundle. Grantee and org are projected as scalars, never nested objects.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetActions added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetActions() []string

GetActions returns CreatePrincipalGrantCreatePrincipalGrant.Actions, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetCreatedAt added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetCreatedAt() string

GetCreatedAt returns CreatePrincipalGrantCreatePrincipalGrant.CreatedAt, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetExpiresAt added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetExpiresAt() *string

GetExpiresAt returns CreatePrincipalGrantCreatePrincipalGrant.ExpiresAt, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetId added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetId() string

GetId returns CreatePrincipalGrantCreatePrincipalGrant.Id, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetOrganizationId added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetOrganizationId() string

GetOrganizationId returns CreatePrincipalGrantCreatePrincipalGrant.OrganizationId, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetOrganizationUrn added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetOrganizationUrn() *string

GetOrganizationUrn returns CreatePrincipalGrantCreatePrincipalGrant.OrganizationUrn, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetPrincipalHandle added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetPrincipalHandle() *string

GetPrincipalHandle returns CreatePrincipalGrantCreatePrincipalGrant.PrincipalHandle, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetPrincipalId added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetPrincipalId() string

GetPrincipalId returns CreatePrincipalGrantCreatePrincipalGrant.PrincipalId, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) GetPrincipalType added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) GetPrincipalType() string

GetPrincipalType returns CreatePrincipalGrantCreatePrincipalGrant.PrincipalType, and is useful for accessing the field via an interface.

func (*CreatePrincipalGrantCreatePrincipalGrant) MarshalJSON added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) MarshalJSON() ([]byte, error)

func (*CreatePrincipalGrantCreatePrincipalGrant) UnmarshalJSON added in v0.7.0 

func (v *CreatePrincipalGrantCreatePrincipalGrant) UnmarshalJSON(b []byte) error

type CreatePrincipalGrantResponse added in v0.7.0 

type CreatePrincipalGrantResponse struct {
	// Grant a member extra management actions (org-ADMIN, interactive-only; design:grant-model). The grantee must be a live member of the org.
	CreatePrincipalGrant *CreatePrincipalGrantCreatePrincipalGrant `json:"createPrincipalGrant"`
}

CreatePrincipalGrantResponse is returned by CreatePrincipalGrant on success.

func CreatePrincipalGrant added in v0.7.0 

func CreatePrincipalGrant(
	ctx_ context.Context,
	client_ graphql.Client,
	orgRef string,
	userRef string,
	actions []string,
	expiresAt *string,
) (data_ *CreatePrincipalGrantResponse, err_ error)

Grant a member extra management actions (org ADMIN, interactive-only).

func (*CreatePrincipalGrantResponse) GetCreatePrincipalGrant added in v0.7.0 

func (v *CreatePrincipalGrantResponse) GetCreatePrincipalGrant() *CreatePrincipalGrantCreatePrincipalGrant

GetCreatePrincipalGrant returns CreatePrincipalGrantResponse.CreatePrincipalGrant, and is useful for accessing the field via an interface.

type CreateRegisterEntryCreateRegisterEntry added in v0.15.0 

type CreateRegisterEntryCreateRegisterEntry struct {
	RegisterEntryFields `json:"-"`
}

CreateRegisterEntryCreateRegisterEntry includes the requested fields of the GraphQL type RegisterEntry. The GraphQL type's documentation follows.

A REGISTER ENTRY (spec 049, D-2026-09-13-007): "this attendee takes part in this Channel". The attendee is a Worker when cast, otherwise an Agent in an App; both null = every attendee in the owner's context (org-wide for an organization row, App-wide for an App row). Not a trigger list — a row never starts a run. The register never grants: what the attendee may read or post is the Channel's host memory's decision. Not exportable.

func (*CreateRegisterEntryCreateRegisterEntry) GetAttendeeUrn added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetAttendeeUrn() *string

GetAttendeeUrn returns CreateRegisterEntryCreateRegisterEntry.AttendeeUrn, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetChannelId added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetChannelId() string

GetChannelId returns CreateRegisterEntryCreateRegisterEntry.ChannelId, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetCreatedAt added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetCreatedAt() string

GetCreatedAt returns CreateRegisterEntryCreateRegisterEntry.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetDescription added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetDescription() *string

GetDescription returns CreateRegisterEntryCreateRegisterEntry.Description, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetId added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetId() string

GetId returns CreateRegisterEntryCreateRegisterEntry.Id, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetInstallDefault added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetInstallDefault() bool

GetInstallDefault returns CreateRegisterEntryCreateRegisterEntry.InstallDefault, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetMentionOnly added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetMentionOnly() bool

GetMentionOnly returns CreateRegisterEntryCreateRegisterEntry.MentionOnly, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetOrganizationId added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetOrganizationId() *string

GetOrganizationId returns CreateRegisterEntryCreateRegisterEntry.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetOwnerId added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetOwnerId() string

GetOwnerId returns CreateRegisterEntryCreateRegisterEntry.OwnerId, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetOwnerType added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetOwnerType() RegisterOwnerType

GetOwnerType returns CreateRegisterEntryCreateRegisterEntry.OwnerType, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetRole added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetRole() RegisterRole

GetRole returns CreateRegisterEntryCreateRegisterEntry.Role, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) GetUpdatedAt added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) GetUpdatedAt() *string

GetUpdatedAt returns CreateRegisterEntryCreateRegisterEntry.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryCreateRegisterEntry) MarshalJSON added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) MarshalJSON() ([]byte, error)

func (*CreateRegisterEntryCreateRegisterEntry) UnmarshalJSON added in v0.15.0 

func (v *CreateRegisterEntryCreateRegisterEntry) UnmarshalJSON(b []byte) error

type CreateRegisterEntryInput added in v0.15.0 

type CreateRegisterEntryInput struct {
	// A Worker or an Agent in the owner's context; omitted = every attendee there.
	AttendeeRef *string `json:"attendeeRef,omitempty"`
	// A Channel: its id or its address (Channel.chatRootUrn, #1171).
	ChannelRef  string  `json:"channelRef"`
	Description *string `json:"description,omitempty"`
	MentionOnly *bool   `json:"mentionOnly,omitempty"`
	// An App or an organization (URN or id).
	OwnerRef string `json:"ownerRef"`
	// Default BOTH.
	Role *RegisterRole `json:"role,omitempty"`
}

func (*CreateRegisterEntryInput) GetAttendeeRef added in v0.15.0 

func (v *CreateRegisterEntryInput) GetAttendeeRef() *string

GetAttendeeRef returns CreateRegisterEntryInput.AttendeeRef, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryInput) GetChannelRef added in v0.15.0 

func (v *CreateRegisterEntryInput) GetChannelRef() string

GetChannelRef returns CreateRegisterEntryInput.ChannelRef, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryInput) GetDescription added in v0.15.0 

func (v *CreateRegisterEntryInput) GetDescription() *string

GetDescription returns CreateRegisterEntryInput.Description, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryInput) GetMentionOnly added in v0.15.0 

func (v *CreateRegisterEntryInput) GetMentionOnly() *bool

GetMentionOnly returns CreateRegisterEntryInput.MentionOnly, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryInput) GetOwnerRef added in v0.15.0 

func (v *CreateRegisterEntryInput) GetOwnerRef() string

GetOwnerRef returns CreateRegisterEntryInput.OwnerRef, and is useful for accessing the field via an interface.

func (*CreateRegisterEntryInput) GetRole added in v0.15.0 

func (v *CreateRegisterEntryInput) GetRole() *RegisterRole

GetRole returns CreateRegisterEntryInput.Role, and is useful for accessing the field via an interface.

type CreateRegisterEntryResponse added in v0.15.0 

type CreateRegisterEntryResponse struct {
	// Spec 049 Phase 5 — declare that an attendee takes part in a Channel. Owner:
	// an App (org ADMIN / owner of a user-owned App) or an organization
	// (CONTRIBUTOR+). attendeeRef: a Worker or an Agent in the owner's context;
	// omitted = every attendee there. REGISTER_ENTRY_EXISTS when a live row
	// already holds that (owner, Channel, attendee). Intent, never permission.
	CreateRegisterEntry *CreateRegisterEntryCreateRegisterEntry `json:"createRegisterEntry"`
}

CreateRegisterEntryResponse is returned by CreateRegisterEntry on success.

func CreateRegisterEntry added in v0.15.0 

func CreateRegisterEntry(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateRegisterEntryInput,
) (data_ *CreateRegisterEntryResponse, err_ error)

attendeeRef omitted is the WIDE row. Optional on the wire, never optional in the command: `register add` requires --attendee or --all-attendees.

func (*CreateRegisterEntryResponse) GetCreateRegisterEntry added in v0.15.0 

func (v *CreateRegisterEntryResponse) GetCreateRegisterEntry() *CreateRegisterEntryCreateRegisterEntry

GetCreateRegisterEntry returns CreateRegisterEntryResponse.CreateRegisterEntry, and is useful for accessing the field via an interface.

type CreateReviewNodeCreateReviewNode added in v0.14.0 

type CreateReviewNodeCreateReviewNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

CreateReviewNodeCreateReviewNode includes the requested fields of the GraphQL type Node.

func (*CreateReviewNodeCreateReviewNode) GetId added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetId() string

GetId returns CreateReviewNodeCreateReviewNode.Id, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetIsRunnable added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetIsRunnable() *bool

GetIsRunnable returns CreateReviewNodeCreateReviewNode.IsRunnable, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetLoc added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetLoc() string

GetLoc returns CreateReviewNodeCreateReviewNode.Loc, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetMemoryId added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetMemoryId() string

GetMemoryId returns CreateReviewNodeCreateReviewNode.MemoryId, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetName added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetName() string

GetName returns CreateReviewNodeCreateReviewNode.Name, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetNodeType added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetNodeType() string

GetNodeType returns CreateReviewNodeCreateReviewNode.NodeType, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetRole added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetRole() *string

GetRole returns CreateReviewNodeCreateReviewNode.Role, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetSeq added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetSeq() *int

GetSeq returns CreateReviewNodeCreateReviewNode.Seq, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetTags added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetTags() []string

GetTags returns CreateReviewNodeCreateReviewNode.Tags, and is useful for accessing the field via an interface.

func (*CreateReviewNodeCreateReviewNode) GetUpdatedAt added in v0.14.0 

func (v *CreateReviewNodeCreateReviewNode) GetUpdatedAt() string

GetUpdatedAt returns CreateReviewNodeCreateReviewNode.UpdatedAt, and is useful for accessing the field via an interface.

type CreateReviewNodeResponse added in v0.14.0 

type CreateReviewNodeResponse struct {
	// #1201 — the CREATE door for the review kind. A write that would produce a
	// node with role: 'review' or a dotted 'review.*' sub-role must come through here; the generic createNode
	// refuses it.
	//
	// PURE ROUTING: it validates nothing and knows nothing beyond which kind it is
	// the door for. The authoring RULES stay in the tool that owns them ('hadron
	// spec', 'hadron coding'), which is a closed-list exception on the audience
	// ground.
	//
	// STRENGTH: SECURITY. A review is not coding-specific — any work performed can be reviewed, and a review may be a SAFETY CHECK. So an attacker can modify a work assignment AND remove the reviews meant to catch that. Omitting the label is self-defeating in its own way: an unlabelled check is invisible to the review tooling, so it is not a check.
	//
	// Exempt from its OWN kind only — it is fully subject to every other kind and
	// to Channel address protection, so it cannot forge a chat message.
	// This mutation is not itself an MCP tool; its MCP counterpart is the
	// deliberate hadron_create_review tool, separate from hadron_create_node,
	// which refuses (#1301 names it in the refusal).
	CreateReviewNode *CreateReviewNodeCreateReviewNode `json:"createReviewNode"`
}

CreateReviewNodeResponse is returned by CreateReviewNode on success.

func CreateReviewNode added in v0.14.0 

func CreateReviewNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateNodeInput,
) (data_ *CreateReviewNodeResponse, err_ error)

func (*CreateReviewNodeResponse) GetCreateReviewNode added in v0.14.0 

func (v *CreateReviewNodeResponse) GetCreateReviewNode() *CreateReviewNodeCreateReviewNode

GetCreateReviewNode returns CreateReviewNodeResponse.CreateReviewNode, and is useful for accessing the field via an interface.

type CreateScopeCreateScope added in v0.14.0 

type CreateScopeCreateScope struct {
	ScopeFields   `json:"-"`
	ScopeMemories `json:"-"`
}

CreateScopeCreateScope includes the requested fields of the GraphQL type Scope. The GraphQL type's documentation follows.

A named search SCOPE: an ORDERED list of memories with exactly one owner (organization | Agent | App). Selects memories only — no saved filter, no retrieval parameters — and NEVER grants: `memories` is the stored list ∩ what YOU may read (D-2026-09-13-004), and `hiddenMemoryCount` says how many you cannot see, as a count only. Names are unique per owner; `global` and `app` are reserved (the ladder's own views). Collisions across owners in an App's context resolve App › Agent › organization, never unioned.

func (*CreateScopeCreateScope) GetCreatedAt added in v0.14.0 

func (v *CreateScopeCreateScope) GetCreatedAt() string

GetCreatedAt returns CreateScopeCreateScope.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetDescription added in v0.14.0 

func (v *CreateScopeCreateScope) GetDescription() *string

GetDescription returns CreateScopeCreateScope.Description, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetHiddenMemoryCount added in v0.14.0 

func (v *CreateScopeCreateScope) GetHiddenMemoryCount() int

GetHiddenMemoryCount returns CreateScopeCreateScope.HiddenMemoryCount, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetId added in v0.14.0 

func (v *CreateScopeCreateScope) GetId() string

GetId returns CreateScopeCreateScope.Id, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetMemories added in v0.14.0 

func (v *CreateScopeCreateScope) GetMemories() []*ScopeMemoriesMemoriesScopeMemoryEntry

GetMemories returns CreateScopeCreateScope.Memories, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetMemoryCount added in v0.14.0 

func (v *CreateScopeCreateScope) GetMemoryCount() int

GetMemoryCount returns CreateScopeCreateScope.MemoryCount, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetName added in v0.14.0 

func (v *CreateScopeCreateScope) GetName() string

GetName returns CreateScopeCreateScope.Name, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetOwnerId added in v0.14.0 

func (v *CreateScopeCreateScope) GetOwnerId() string

GetOwnerId returns CreateScopeCreateScope.OwnerId, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetOwnerType added in v0.14.0 

func (v *CreateScopeCreateScope) GetOwnerType() ScopeOwnerType

GetOwnerType returns CreateScopeCreateScope.OwnerType, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetOwnerUrn added in v0.14.0 

func (v *CreateScopeCreateScope) GetOwnerUrn() *string

GetOwnerUrn returns CreateScopeCreateScope.OwnerUrn, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) GetUpdatedAt added in v0.14.0 

func (v *CreateScopeCreateScope) GetUpdatedAt() *string

GetUpdatedAt returns CreateScopeCreateScope.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateScopeCreateScope) MarshalJSON added in v0.14.0 

func (v *CreateScopeCreateScope) MarshalJSON() ([]byte, error)

func (*CreateScopeCreateScope) UnmarshalJSON added in v0.14.0 

func (v *CreateScopeCreateScope) UnmarshalJSON(b []byte) error

type CreateScopeInput added in v0.14.0 

type CreateScopeInput struct {
	AgentRef        *string  `json:"agentRef,omitempty"`
	AppRef          *string  `json:"appRef,omitempty"`
	Description     *string  `json:"description,omitempty"`
	MemoryRefs      []string `json:"memoryRefs"`
	Name            string   `json:"name"`
	OrganizationRef *string  `json:"organizationRef,omitempty"`
}

Exactly one of organizationRef / agentRef / appRef. `memoryRefs` is the ORDERED list (IDs or URNs); each must be readable by you — an unreadable memory reads as "no match", the same as a nonexistent one.

func (*CreateScopeInput) GetAgentRef added in v0.14.0 

func (v *CreateScopeInput) GetAgentRef() *string

GetAgentRef returns CreateScopeInput.AgentRef, and is useful for accessing the field via an interface.

func (*CreateScopeInput) GetAppRef added in v0.14.0 

func (v *CreateScopeInput) GetAppRef() *string

GetAppRef returns CreateScopeInput.AppRef, and is useful for accessing the field via an interface.

func (*CreateScopeInput) GetDescription added in v0.14.0 

func (v *CreateScopeInput) GetDescription() *string

GetDescription returns CreateScopeInput.Description, and is useful for accessing the field via an interface.

func (*CreateScopeInput) GetMemoryRefs added in v0.14.0 

func (v *CreateScopeInput) GetMemoryRefs() []string

GetMemoryRefs returns CreateScopeInput.MemoryRefs, and is useful for accessing the field via an interface.

func (*CreateScopeInput) GetName added in v0.14.0 

func (v *CreateScopeInput) GetName() string

GetName returns CreateScopeInput.Name, and is useful for accessing the field via an interface.

func (*CreateScopeInput) GetOrganizationRef added in v0.14.0 

func (v *CreateScopeInput) GetOrganizationRef() *string

GetOrganizationRef returns CreateScopeInput.OrganizationRef, and is useful for accessing the field via an interface.

type CreateScopeResponse added in v0.14.0 

type CreateScopeResponse struct {
	// Spec 049 Phase 2 — create a named scope on exactly one owner. Auth by
	// owner: organization CONTRIBUTOR+; App or Agent ADMIN of the owning org, or
	// the owner of a user-owned one. Name 1–64 [a-z0-9_-], unique per owner
	// among live scopes (SCOPE_NAME_TAKEN), never `global` / `app`.
	CreateScope *CreateScopeCreateScope `json:"createScope"`
}

CreateScopeResponse is returned by CreateScope on success.

func CreateScope added in v0.14.0 

func CreateScope(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateScopeInput,
) (data_ *CreateScopeResponse, err_ error)

Create a scope on EXACTLY ONE owner. The server enforces the name rules (1-64 [a-z0-9_-], unique per owner via SCOPE_NAME_TAKEN, never `global` or `app`) — deliberately not duplicated client-side, since a copy drifts.

memoryRefs is ORDERED and required; its order is the scope's order.

The three owner refs carry omitempty so the two the caller did NOT pick are absent from the wire rather than sent as explicit nulls — the server's rule is "exactly one owner", and a null is a value being offered. (Signature kept expanded so the `for:` directives bind; see UpdateScope below.)

func (*CreateScopeResponse) GetCreateScope added in v0.14.0 

func (v *CreateScopeResponse) GetCreateScope() *CreateScopeCreateScope

GetCreateScope returns CreateScopeResponse.CreateScope, and is useful for accessing the field via an interface.

type CreateSecretCreateSecret added in v0.8.0 

type CreateSecretCreateSecret struct {
	SecretFields `json:"-"`
}

CreateSecretCreateSecret includes the requested fields of the GraphQL type Secret. The GraphQL type's documentation follows.

One named, owner-scoped secret — the general secret store (#677). Polymorphic owner (user | org | app | memory). The value is encrypted at rest and WRITE-ONLY: no field here ever returns it — kind + metadata are the inspectable half (you can see THAT a secret exists and, for webfetch-auth, WHERE it applies, without decrypting). A bare name resolves at run time via the CSS cascade, most-specific-first: memory -> app -> user -> org.

func (*CreateSecretCreateSecret) GetCreatedAt added in v0.8.0 

func (v *CreateSecretCreateSecret) GetCreatedAt() string

GetCreatedAt returns CreateSecretCreateSecret.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetCreatedBy added in v0.8.0 

func (v *CreateSecretCreateSecret) GetCreatedBy() *string

GetCreatedBy returns CreateSecretCreateSecret.CreatedBy, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetId added in v0.8.0 

func (v *CreateSecretCreateSecret) GetId() string

GetId returns CreateSecretCreateSecret.Id, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetKind added in v0.8.0 

func (v *CreateSecretCreateSecret) GetKind() string

GetKind returns CreateSecretCreateSecret.Kind, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetMetadata added in v0.8.0 

func (v *CreateSecretCreateSecret) GetMetadata() *json.RawMessage

GetMetadata returns CreateSecretCreateSecret.Metadata, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetName added in v0.8.0 

func (v *CreateSecretCreateSecret) GetName() string

GetName returns CreateSecretCreateSecret.Name, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetOwnerId added in v0.8.0 

func (v *CreateSecretCreateSecret) GetOwnerId() string

GetOwnerId returns CreateSecretCreateSecret.OwnerId, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetOwnerType added in v0.8.0 

func (v *CreateSecretCreateSecret) GetOwnerType() string

GetOwnerType returns CreateSecretCreateSecret.OwnerType, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetUpdatedAt added in v0.8.0 

func (v *CreateSecretCreateSecret) GetUpdatedAt() string

GetUpdatedAt returns CreateSecretCreateSecret.UpdatedAt, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) GetUpdatedBy added in v0.8.0 

func (v *CreateSecretCreateSecret) GetUpdatedBy() *string

GetUpdatedBy returns CreateSecretCreateSecret.UpdatedBy, and is useful for accessing the field via an interface.

func (*CreateSecretCreateSecret) MarshalJSON added in v0.8.0 

func (v *CreateSecretCreateSecret) MarshalJSON() ([]byte, error)

func (*CreateSecretCreateSecret) UnmarshalJSON added in v0.8.0 

func (v *CreateSecretCreateSecret) UnmarshalJSON(b []byte) error

type CreateSecretResponse added in v0.8.0 

type CreateSecretResponse struct {
	// Create a named, owner-scoped secret (#677). Gate per owner scope:
	// user -> that user (ownerRef optional, defaults to the caller); org ->
	// org ADMIN; app -> app owner / org ADMIN; memory -> memory WRITE.
	// value is the secret payload — encrypted at rest, write-only, never
	// returned. kind selects validation: generic (opaque JSON) or
	// webfetch-auth ({type: bearer|basic|header, ...} + metadata.urlPrefix
	// origin binding). A run resolves the name via the CSS cascade
	// (memory -> app -> user -> org) at entitled scopes only.
	CreateSecret *CreateSecretCreateSecret `json:"createSecret"`
}

CreateSecretResponse is returned by CreateSecret on success.

func CreateSecret added in v0.8.0 

func CreateSecret(
	ctx_ context.Context,
	client_ graphql.Client,
	ownerType string,
	ownerRef *string,
	name string,
	kind string,
	metadata *json.RawMessage,
	value json.RawMessage,
) (data_ *CreateSecretResponse, err_ error)

func (*CreateSecretResponse) GetCreateSecret added in v0.8.0 

func (v *CreateSecretResponse) GetCreateSecret() *CreateSecretCreateSecret

GetCreateSecret returns CreateSecretResponse.CreateSecret, and is useful for accessing the field via an interface.

type CreateSpecNodeCreateSpecNode added in v0.14.0 

type CreateSpecNodeCreateSpecNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

CreateSpecNodeCreateSpecNode includes the requested fields of the GraphQL type Node.

func (*CreateSpecNodeCreateSpecNode) GetId added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetId() string

GetId returns CreateSpecNodeCreateSpecNode.Id, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetIsRunnable added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetIsRunnable() *bool

GetIsRunnable returns CreateSpecNodeCreateSpecNode.IsRunnable, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetLoc added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetLoc() string

GetLoc returns CreateSpecNodeCreateSpecNode.Loc, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetMemoryId added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetMemoryId() string

GetMemoryId returns CreateSpecNodeCreateSpecNode.MemoryId, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetName added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetName() string

GetName returns CreateSpecNodeCreateSpecNode.Name, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetNodeType added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetNodeType() string

GetNodeType returns CreateSpecNodeCreateSpecNode.NodeType, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetRole added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetRole() *string

GetRole returns CreateSpecNodeCreateSpecNode.Role, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetSeq added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetSeq() *int

GetSeq returns CreateSpecNodeCreateSpecNode.Seq, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetTags added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetTags() []string

GetTags returns CreateSpecNodeCreateSpecNode.Tags, and is useful for accessing the field via an interface.

func (*CreateSpecNodeCreateSpecNode) GetUpdatedAt added in v0.14.0 

func (v *CreateSpecNodeCreateSpecNode) GetUpdatedAt() string

GetUpdatedAt returns CreateSpecNodeCreateSpecNode.UpdatedAt, and is useful for accessing the field via an interface.

type CreateSpecNodeResponse added in v0.14.0 

type CreateSpecNodeResponse struct {
	// #1201 — the CREATE door for the spec kind. A write that would produce a
	// node with role: 'spec' or a dotted 'spec.*' sub-role must come through here; the generic createNode
	// refuses it.
	//
	// PURE ROUTING: it validates nothing and knows nothing beyond which kind it is
	// the door for. The authoring RULES stay in the tool that owns them ('hadron
	// spec', 'hadron coding'), which is a closed-list exception on the audience
	// ground.
	//
	// STRENGTH: DILIGENCE. It guarantees a spec node was authored by the spec tool (#1152, and the corpus discipline resting on it). It does NOT claim a determined caller could not author one another way: the label is free to omit and a citation resolves without it. Specs are deliberately not treated as a security concern; the destructive half is closed by #1182/#1184, which made createNode mint-or-refuse and race-safe.
	//
	// Exempt from its OWN kind only — it is fully subject to every other kind and
	// to Channel address protection, so it cannot forge a chat message.
	// Deliberately NOT an MCP tool: an agent's node surface is hadron_create_node,
	// which refuses, and that absence is the mechanism rather than an oversight.
	CreateSpecNode *CreateSpecNodeCreateSpecNode `json:"createSpecNode"`
}

CreateSpecNodeResponse is returned by CreateSpecNode on success.

func CreateSpecNode added in v0.14.0 

func CreateSpecNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateNodeInput,
) (data_ *CreateSpecNodeResponse, err_ error)

---- The kind-specific authoring doors (hadron-server #1201, cli #606) ----

#1203 REPLACED the single `authorProtectedNode` with one door per KIND, and DELETED the generic one — so this is not a rename that could be deferred: the old field no longer exists on the server and every call site broke at once.

A door is named for what it writes and is exempt from its OWN kind only, so holding one is no longer a skeleton key over every declared address. It stays PURE ROUTING: it validates nothing `createNode` does not, and the authoring rules stay in `hadron spec` / `hadron coding`, which are on the closed exception list (cor:api:240:02) on the audience ground.

THE GATE READS THE NODE'S KIND, not the request: a write needs the door of every kind it touches — what the node WILL BE, and for an update what it IS now (before ∪ after; removing a kind needs that kind's door, cli#714):

role: "spec" -> createSpecNode / updateSpecNode (DILIGENCE) role: "review" -> createReviewNode / updateReviewNode (SECURITY) isRunnable: true -> createTaskNode / updateTaskNode (CAPABILITY)

The three are NOT equally strong and the server's own SDL says so. Spec is diligence — it attests the spec tool authored the node, not that nobody else could. Review is security: a review may be a safety check, so removing one is the attack. Task is the only capability gate, because `isRunnable` cannot be dropped to evade it without the node ceasing to run.

`Memory.protectedLocs` is GONE (#1203). Nothing is protected by ADDRESS any more, which is why `coding preflight add` writes through the generic `createNode` again: its route targets are non-runnable orientation nodes carrying no role, so they are not of any governed kind.

NO `upsert` ARGUMENT. The old door took one and every call site passed false; the new doors do not offer it, so the re-run case is a NodeLocConflictError (exit 5) rather than a silent overwrite of a permanent citation — which is what those call sites were asking for anyway.

func (*CreateSpecNodeResponse) GetCreateSpecNode added in v0.14.0 

func (v *CreateSpecNodeResponse) GetCreateSpecNode() *CreateSpecNodeCreateSpecNode

GetCreateSpecNode returns CreateSpecNodeResponse.CreateSpecNode, and is useful for accessing the field via an interface.

type CreateTaskNodeCreateTaskNode added in v0.14.0 

type CreateTaskNodeCreateTaskNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

CreateTaskNodeCreateTaskNode includes the requested fields of the GraphQL type Node.

func (*CreateTaskNodeCreateTaskNode) GetId added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetId() string

GetId returns CreateTaskNodeCreateTaskNode.Id, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetIsRunnable added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetIsRunnable() *bool

GetIsRunnable returns CreateTaskNodeCreateTaskNode.IsRunnable, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetLoc added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetLoc() string

GetLoc returns CreateTaskNodeCreateTaskNode.Loc, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetMemoryId added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetMemoryId() string

GetMemoryId returns CreateTaskNodeCreateTaskNode.MemoryId, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetName added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetName() string

GetName returns CreateTaskNodeCreateTaskNode.Name, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetNodeType added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetNodeType() string

GetNodeType returns CreateTaskNodeCreateTaskNode.NodeType, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetRole added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetRole() *string

GetRole returns CreateTaskNodeCreateTaskNode.Role, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetSeq added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetSeq() *int

GetSeq returns CreateTaskNodeCreateTaskNode.Seq, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetTags added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetTags() []string

GetTags returns CreateTaskNodeCreateTaskNode.Tags, and is useful for accessing the field via an interface.

func (*CreateTaskNodeCreateTaskNode) GetUpdatedAt added in v0.14.0 

func (v *CreateTaskNodeCreateTaskNode) GetUpdatedAt() string

GetUpdatedAt returns CreateTaskNodeCreateTaskNode.UpdatedAt, and is useful for accessing the field via an interface.

type CreateTaskNodeResponse added in v0.14.0 

type CreateTaskNodeResponse struct {
	// #1201 — the CREATE door for the task kind. A write that would produce a
	// node with isRunnable: true must come through here; the generic createNode
	// refuses it.
	//
	// PURE ROUTING: it validates nothing and knows nothing beyond which kind it is
	// the door for. The authoring RULES stay in the tool that owns them ('hadron
	// spec', 'hadron coding'), which is a closed-list exception on the audience
	// ground.
	//
	// STRENGTH: CAPABILITY. The only one of the three whose gate cannot be evaded by omission, which is why it carries the security case. It keys on 'isRunnable' rather than on 'role': a label is caller-set and freely dropped, while omitting the capability means the node does not run. The threat is a memory shared with someone who authors a runnable node that reads the owner's data when the OWNER runs it (#1202).
	//
	// Exempt from its OWN kind only — it is fully subject to every other kind and
	// to Channel address protection, so it cannot forge a chat message.
	// This mutation is not itself an MCP tool; its MCP counterpart is the
	// deliberate hadron_create_task tool, separate from hadron_create_node,
	// which refuses (#1301 names it in the refusal).
	CreateTaskNode *CreateTaskNodeCreateTaskNode `json:"createTaskNode"`
}

CreateTaskNodeResponse is returned by CreateTaskNode on success.

func CreateTaskNode added in v0.14.0 

func CreateTaskNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *CreateNodeInput,
) (data_ *CreateTaskNodeResponse, err_ error)

func (*CreateTaskNodeResponse) GetCreateTaskNode added in v0.14.0 

func (v *CreateTaskNodeResponse) GetCreateTaskNode() *CreateTaskNodeCreateTaskNode

GetCreateTaskNode returns CreateTaskNodeResponse.CreateTaskNode, and is useful for accessing the field via an interface.

type CreateTeamChatMessageCreateTeamChatMessage added in v0.9.0 

type CreateTeamChatMessageCreateTeamChatMessage struct {
	TeamChatMessageFields `json:"-"`
}

CreateTeamChatMessageCreateTeamChatMessage includes the requested fields of the GraphQL type TeamChatMessage. The GraphQL type's documentation follows.

One message in a team App's chat (#939, Worker envelope since #974). Exactly one of authorUserId / authorWorkerId is set: a human post carries the user, a worker post carries the Worker (the named casting, cor:dmo:050:11) plus the driving sessionId. mentions holds the lowercased tokens extracted server-side at write time (the '@worker-name / @handle' format, stored without the '@').

func (*CreateTeamChatMessageCreateTeamChatMessage) GetAt added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetAt() string

GetAt returns CreateTeamChatMessageCreateTeamChatMessage.At, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetAuthorName added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetAuthorName() *string

GetAuthorName returns CreateTeamChatMessageCreateTeamChatMessage.AuthorName, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetAuthorUserId added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetAuthorUserId() *string

GetAuthorUserId returns CreateTeamChatMessageCreateTeamChatMessage.AuthorUserId, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetAuthorWorkerId added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetAuthorWorkerId() *string

GetAuthorWorkerId returns CreateTeamChatMessageCreateTeamChatMessage.AuthorWorkerId, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetBody added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetBody() string

GetBody returns CreateTeamChatMessageCreateTeamChatMessage.Body, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetMentions added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetMentions() []string

GetMentions returns CreateTeamChatMessageCreateTeamChatMessage.Mentions, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetNodeId added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetNodeId() string

GetNodeId returns CreateTeamChatMessageCreateTeamChatMessage.NodeId, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetReplyToSeq added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetReplyToSeq() *int

GetReplyToSeq returns CreateTeamChatMessageCreateTeamChatMessage.ReplyToSeq, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetSeq added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetSeq() int

GetSeq returns CreateTeamChatMessageCreateTeamChatMessage.Seq, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) GetSessionId added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) GetSessionId() *string

GetSessionId returns CreateTeamChatMessageCreateTeamChatMessage.SessionId, and is useful for accessing the field via an interface.

func (*CreateTeamChatMessageCreateTeamChatMessage) MarshalJSON added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) MarshalJSON() ([]byte, error)

func (*CreateTeamChatMessageCreateTeamChatMessage) UnmarshalJSON added in v0.9.0 

func (v *CreateTeamChatMessageCreateTeamChatMessage) UnmarshalJSON(b []byte) error

type CreateTeamChatMessageResponse added in v0.9.0 

type CreateTeamChatMessageResponse struct {
	// Post a message into a team App's chat (#939) as a platform operation.
	// The team chat is ONE well-known chat per team App, at loc chats:team in
	// the Team Agent's shared app-class memory, bootstrapped on first post.
	// The message is written through the atomic chat-message allocator (#919),
	// so racing posts get distinct consecutive seqs.
	//
	// Author derivation (#974): with sessionRef, the message is authored by
	// that session's bound Worker (the session must be writable by the caller, a
	// session OF this App, active, and bound to a non-retired Worker OF this
	// App — the worker-App pin, checked at post time so retirement revokes) and
	// the envelope records the driving sessionId; without it, by the calling
	// human. Mentions ('@worker-name' / '@handle'; a multi-word name is
	// mentioned by its slug, e.g. '@mary-jane') are extracted server-side at
	// write time into the envelope. replyToSeq wires a replies-to edge to the
	// cited message. body is capped at 65536 characters.
	//
	// Authorization: an AppMember of the App (any role — every member of the
	// host is a participant per cor:acl:030:01), an org member with
	// CONTRIBUTOR+ on the App's org, or the owner of a user-owned App. Pure
	// App-key principals cannot post.
	//
	// Spec 049 Phase 8 (item J): the worker-App pin became the host-memory
	// write check. A session's Worker authors here when its App is this one,
	// OR when the session's on-behalf-of user may write the Channel's host
	// memory — a cross-App post records authorAppId. A pure App-key session is
	// admitted only on the same-App branch. SESSION_NOT_IN_APP and
	// SESSION_WORKER_NOT_IN_APP are retired; CHANNEL_HOST_NOT_WRITABLE is the
	// successor code.
	//
	// Error codes (extensions.code): TEAM_CHAT_BODY_TOO_LARGE,
	// TEAM_CHAT_REPLY_NOT_FOUND, SESSION_NOT_FOUND, SESSION_ENDED,
	// SESSION_NOT_WORKER_BOUND, CHANNEL_HOST_NOT_WRITABLE, WORKER_RETIRED,
	// SESSION_EXPIRED (encrypted team memory without an active session key),
	// TEAM_AGENT_NOT_FOUND / TEAM_AGENT_AMBIGUOUS (first-post bootstrap could
	// not locate the Team Agent), APP_UNINSTALLED, FORBIDDEN (an authenticated
	// caller who is not a participant), UNAUTHENTICATED (no principal at all: no
	// token, an expired or unverifiable one; checked before the App is resolved,
	// so it answers identically whether or not the App exists).
	//
	// appRef accepts the entity's ID or URN; sessionRef is the session id.
	CreateTeamChatMessage *CreateTeamChatMessageCreateTeamChatMessage `json:"createTeamChatMessage"`
}

CreateTeamChatMessageResponse is returned by CreateTeamChatMessage on success.

func CreateTeamChatMessage added in v0.9.0 

func CreateTeamChatMessage(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	body string,
	replyToSeq *int,
	sessionRef *string,
) (data_ *CreateTeamChatMessageResponse, err_ error)

func (*CreateTeamChatMessageResponse) GetCreateTeamChatMessage added in v0.9.0 

func (v *CreateTeamChatMessageResponse) GetCreateTeamChatMessage() *CreateTeamChatMessageCreateTeamChatMessage

GetCreateTeamChatMessage returns CreateTeamChatMessageResponse.CreateTeamChatMessage, and is useful for accessing the field via an interface.

type CreateTeamRoleCreateTeamRole added in v0.9.0 

type CreateTeamRoleCreateTeamRole struct {
	TeamRoleFields `json:"-"`
}

CreateTeamRoleCreateTeamRole includes the requested fields of the GraphQL type TeamRole. The GraphQL type's documentation follows.

A role definition (#960): the roles:<role> node in the Team Agent's system memory. #1050: it carries no name register — a role is a definition, not an allocation pool. The prompt template is NOT here — with the Worker model (#974) it lives on the role-agent (personaRole + systemPrompt); roleAgent points at it.

func (*CreateTeamRoleCreateTeamRole) GetDescription added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) GetDescription() *string

GetDescription returns CreateTeamRoleCreateTeamRole.Description, and is useful for accessing the field via an interface.

func (*CreateTeamRoleCreateTeamRole) GetHasNamePlaceholder added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) GetHasNamePlaceholder() *bool

GetHasNamePlaceholder returns CreateTeamRoleCreateTeamRole.HasNamePlaceholder, and is useful for accessing the field via an interface.

func (*CreateTeamRoleCreateTeamRole) GetLoc added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) GetLoc() string

GetLoc returns CreateTeamRoleCreateTeamRole.Loc, and is useful for accessing the field via an interface.

func (*CreateTeamRoleCreateTeamRole) GetNodeId added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) GetNodeId() string

GetNodeId returns CreateTeamRoleCreateTeamRole.NodeId, and is useful for accessing the field via an interface.

func (*CreateTeamRoleCreateTeamRole) GetRole added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) GetRole() string

GetRole returns CreateTeamRoleCreateTeamRole.Role, and is useful for accessing the field via an interface.

func (*CreateTeamRoleCreateTeamRole) GetRoleAgent added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) GetRoleAgent() *TeamRoleFieldsRoleAgent

GetRoleAgent returns CreateTeamRoleCreateTeamRole.RoleAgent, and is useful for accessing the field via an interface.

func (*CreateTeamRoleCreateTeamRole) MarshalJSON added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) MarshalJSON() ([]byte, error)

func (*CreateTeamRoleCreateTeamRole) UnmarshalJSON added in v0.9.0 

func (v *CreateTeamRoleCreateTeamRole) UnmarshalJSON(b []byte) error

type CreateTeamRoleResponse added in v0.9.0 

type CreateTeamRoleResponse struct {
	// #960 — mint a roles:<role> definition in the Team Agent's system memory.
	// Owns the spec knowledge a hand-authoring caller had to carry: the loc is
	// roles:<role> (single atom). Refuses an existing role (TEAM_ROLE_EXISTS —
	// updateTeamRole is the edit path). Authorization is the Team Agent's
	// definition-edit gate: whoever may write the agent's system memory through
	// the generic node surface may write roles — the write delegates to that same
	// seam (encryption, revision snapshot, git mirror included).
	//
	// #1024 deliberately does NOT take `repos` here — set it with
	// updateTeamRole. A create that also wrote data could not be made atomic: the
	// write resurrects a tombstone through an unguarded upsert branch, and
	// splitting it into create-then-guarded-update introduced a partial failure
	// between the halves (the role lands, the repo write refuses). Two explicit
	// calls put that seam where the caller can see and retry it, instead of hiding
	// a non-atomic pair inside one mutation.
	//
	// #1050: a role definition no longer carries a NAME REGISTER. There is no
	// names / nameRange / nameConvention / allowOutOfRange, and no register
	// invariants to run, because names are not allocated — a cast supplies its
	// own and workers_app_name_uniq is the sole arbiter. Any data.names left on
	// an existing node is historical and is neither read nor rewritten.
	CreateTeamRole *CreateTeamRoleCreateTeamRole `json:"createTeamRole"`
}

CreateTeamRoleResponse is returned by CreateTeamRole on success.

func CreateTeamRole added in v0.9.0 

func CreateTeamRole(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	teamAgentRef *string,
	role string,
	description *string,
) (data_ *CreateTeamRoleResponse, err_ error)

── Role writes. Once the register went (hadron-server#1050), a role definition carries a role, a description, and nothing else that a client can set — so create and update are the same two fields, and the CAS, the range/convention keys and the whole `names` sugar went with the register.

func (*CreateTeamRoleResponse) GetCreateTeamRole added in v0.9.0 

func (v *CreateTeamRoleResponse) GetCreateTeamRole() *CreateTeamRoleCreateTeamRole

GetCreateTeamRole returns CreateTeamRoleResponse.CreateTeamRole, and is useful for accessing the field via an interface.

type CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult added in v0.3.0 

type CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult struct {
	RawKey     string                                                            `json:"rawKey"`
	UserApiKey *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey `json:"userApiKey"`
}

CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult includes the requested fields of the GraphQL type UserApiKeyCreateResult. The GraphQL type's documentation follows.

Returned once at creation — the raw key is never stored. Renamed from PR 137's UserApiKeyCreated for Result-suffix consistency; nested field is userApiKey, not key (PR-137 delta D2).

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult) GetRawKey added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult) GetRawKey() string

GetRawKey returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult.RawKey, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult) GetUserApiKey added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult) GetUserApiKey() *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey

GetUserApiKey returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult.UserApiKey, and is useful for accessing the field via an interface.

type CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey added in v0.3.0 

type CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey struct {
	UserApiKeyFields `json:"-"`
}

CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey includes the requested fields of the GraphQL type UserApiKey. The GraphQL type's documentation follows.

025-oauth-for-mcp: user-scoped bearer-token credential. Mirrors the AppKey shape but resolves to a User instead of an App. Surfaced to the portal revocation UI (Phase 3) so users can audit + revoke their own keys. userId is intentionally absent — for self-service v1 the caller is always the owner; admin-tooling auditability is out of scope (see contracts/graphql-mutations.md, PR-137 delta D1).

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetCreatedAt added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetCreatedAt() string

GetCreatedAt returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetId added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetId() string

GetId returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey.Id, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetIssuedVia added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetIssuedVia() *string

GetIssuedVia returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey.IssuedVia, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetKeyPreview added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetKeyPreview() string

GetKeyPreview returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey.KeyPreview, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetLabel added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetLabel() *string

GetLabel returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey.Label, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetLastUsedAt added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetLastUsedAt() *string

GetLastUsedAt returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey.LastUsedAt, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetRevokedAt added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) GetRevokedAt() *string

GetRevokedAt returns CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey.RevokedAt, and is useful for accessing the field via an interface.

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) MarshalJSON added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) MarshalJSON() ([]byte, error)

func (*CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) UnmarshalJSON added in v0.3.0 

func (v *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResultUserApiKey) UnmarshalJSON(b []byte) error

type CreateUserApiKeyResponse added in v0.3.0 

type CreateUserApiKeyResponse struct {
	// 025-oauth-for-mcp FR-004: mint a new user-scoped API key for the
	// calling User. Returns the raw key exactly once (the server stores
	// only the SHA-256 hash). Rejected with UNAUTHENTICATED for AppKey-
	// resolved callers (no user in context). Per Clarifications, label
	// is optional (portal defaults to a placeholder when omitted).
	CreateUserApiKey *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult `json:"createUserApiKey"`
}

CreateUserApiKeyResponse is returned by CreateUserApiKey on success.

func CreateUserApiKey added in v0.3.0 

func CreateUserApiKey(
	ctx_ context.Context,
	client_ graphql.Client,
	label *string,
) (data_ *CreateUserApiKeyResponse, err_ error)

Returns the raw key EXACTLY ONCE (the server stores only its hash). label is optional — omitted lets the server apply its placeholder default.

func (*CreateUserApiKeyResponse) GetCreateUserApiKey added in v0.3.0 

func (v *CreateUserApiKeyResponse) GetCreateUserApiKey() *CreateUserApiKeyCreateUserApiKeyUserApiKeyCreateResult

GetCreateUserApiKey returns CreateUserApiKeyResponse.CreateUserApiKey, and is useful for accessing the field via an interface.

type CreateUserInvitationCreateUserInvitation added in v0.7.0 

type CreateUserInvitationCreateUserInvitation struct {
	InvitationFields `json:"-"`
}

CreateUserInvitationCreateUserInvitation includes the requested fields of the GraphQL type UserInvitation. The GraphQL type's documentation follows.

Invitation to join the platform (and optionally an organization)

func (*CreateUserInvitationCreateUserInvitation) GetAcceptedAt added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetAcceptedAt() *string

GetAcceptedAt returns CreateUserInvitationCreateUserInvitation.AcceptedAt, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetActivationCount added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetActivationCount() int

GetActivationCount returns CreateUserInvitationCreateUserInvitation.ActivationCount, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetCreatedAt added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetCreatedAt() string

GetCreatedAt returns CreateUserInvitationCreateUserInvitation.CreatedAt, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetEmail added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetEmail() *string

GetEmail returns CreateUserInvitationCreateUserInvitation.Email, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetExpiresAt added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetExpiresAt() *string

GetExpiresAt returns CreateUserInvitationCreateUserInvitation.ExpiresAt, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetGithubUsername added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetGithubUsername() *string

GetGithubUsername returns CreateUserInvitationCreateUserInvitation.GithubUsername, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetId added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetId() string

GetId returns CreateUserInvitationCreateUserInvitation.Id, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetMaxActivations added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetMaxActivations() *int

GetMaxActivations returns CreateUserInvitationCreateUserInvitation.MaxActivations, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetMemberRole added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetMemberRole() Role

GetMemberRole returns CreateUserInvitationCreateUserInvitation.MemberRole, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetName added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetName() *string

GetName returns CreateUserInvitationCreateUserInvitation.Name, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetOrganizationId added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetOrganizationId() *string

GetOrganizationId returns CreateUserInvitationCreateUserInvitation.OrganizationId, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) GetSlug added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) GetSlug() string

GetSlug returns CreateUserInvitationCreateUserInvitation.Slug, and is useful for accessing the field via an interface.

func (*CreateUserInvitationCreateUserInvitation) MarshalJSON added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) MarshalJSON() ([]byte, error)

func (*CreateUserInvitationCreateUserInvitation) UnmarshalJSON added in v0.7.0 

func (v *CreateUserInvitationCreateUserInvitation) UnmarshalJSON(b []byte) error

type CreateUserInvitationResponse added in v0.7.0 

type CreateUserInvitationResponse struct {
	// User invitations (org ADMIN or platform ADMIN).
	//
	// Accepts the entity's ID or URN.
	CreateUserInvitation *CreateUserInvitationCreateUserInvitation `json:"createUserInvitation"`
}

CreateUserInvitationResponse is returned by CreateUserInvitation on success.

func CreateUserInvitation added in v0.7.0 

func CreateUserInvitation(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId string,
	memberRole Role,
	email *string,
	name *string,
	githubUsername *string,
	expiresInDays *int,
	maxActivations *int,
) (data_ *CreateUserInvitationResponse, err_ error)

Org-scoped invitation (#56). The returned `slug` is the acceptance token the invitee redeems with `org invite accept <slug>`.

func (*CreateUserInvitationResponse) GetCreateUserInvitation added in v0.7.0 

func (v *CreateUserInvitationResponse) GetCreateUserInvitation() *CreateUserInvitationCreateUserInvitation

GetCreateUserInvitation returns CreateUserInvitationResponse.CreateUserInvitation, and is useful for accessing the field via an interface.

type DeleteAgentResponse added in v0.7.0 

type DeleteAgentResponse struct {
	// Soft-delete an Agent.
	//
	// Accepts the entity's ID or URN.
	DeleteAgent bool `json:"deleteAgent"`
}

DeleteAgentResponse is returned by DeleteAgent on success.

func DeleteAgent added in v0.7.0 

func DeleteAgent(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *DeleteAgentResponse, err_ error)

func (*DeleteAgentResponse) GetDeleteAgent added in v0.7.0 

func (v *DeleteAgentResponse) GetDeleteAgent() bool

GetDeleteAgent returns DeleteAgentResponse.DeleteAgent, and is useful for accessing the field via an interface.

type DeleteAgentScheduleResponse added in v0.6.0 

type DeleteAgentScheduleResponse struct {
	DeleteAgentSchedule bool `json:"deleteAgentSchedule"`
}

DeleteAgentScheduleResponse is returned by DeleteAgentSchedule on success.

func DeleteAgentSchedule added in v0.6.0 

func DeleteAgentSchedule(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *DeleteAgentScheduleResponse, err_ error)

func (*DeleteAgentScheduleResponse) GetDeleteAgentSchedule added in v0.6.0 

func (v *DeleteAgentScheduleResponse) GetDeleteAgentSchedule() bool

GetDeleteAgentSchedule returns DeleteAgentScheduleResponse.DeleteAgentSchedule, and is useful for accessing the field via an interface.

type DeleteAgentWebhookResponse added in v0.6.0 

type DeleteAgentWebhookResponse struct {
	DeleteAgentWebhook bool `json:"deleteAgentWebhook"`
}

DeleteAgentWebhookResponse is returned by DeleteAgentWebhook on success.

func DeleteAgentWebhook added in v0.6.0 

func DeleteAgentWebhook(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *DeleteAgentWebhookResponse, err_ error)

func (*DeleteAgentWebhookResponse) GetDeleteAgentWebhook added in v0.6.0 

func (v *DeleteAgentWebhookResponse) GetDeleteAgentWebhook() bool

GetDeleteAgentWebhook returns DeleteAgentWebhookResponse.DeleteAgentWebhook, and is useful for accessing the field via an interface.

type DeleteAiServiceConfigResponse added in v0.3.0 

type DeleteAiServiceConfigResponse struct {
	// 036-ai-service-config: delete a named AI config (hard delete; the
	// resolution walk simply no longer finds it).
	//
	// Auth: admin rights on the owning entity (as aiServiceConfigs).
	DeleteAiServiceConfig bool `json:"deleteAiServiceConfig"`
}

DeleteAiServiceConfigResponse is returned by DeleteAiServiceConfig on success.

func DeleteAiServiceConfig added in v0.3.0 

func DeleteAiServiceConfig(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *DeleteAiServiceConfigResponse, err_ error)

func (*DeleteAiServiceConfigResponse) GetDeleteAiServiceConfig added in v0.3.0 

func (v *DeleteAiServiceConfigResponse) GetDeleteAiServiceConfig() bool

GetDeleteAiServiceConfig returns DeleteAiServiceConfigResponse.DeleteAiServiceConfig, and is useful for accessing the field via an interface.

type DeleteAppResponse 

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

DeleteAppResponse is returned by DeleteApp on success.

func DeleteApp 

func DeleteApp(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *DeleteAppResponse, err_ error)

func (*DeleteAppResponse) GetDeleteApp 

func (v *DeleteAppResponse) GetDeleteApp() bool

GetDeleteApp returns DeleteAppResponse.DeleteApp, and is useful for accessing the field via an interface.

type DeleteChannelResponse added in v0.14.0 

type DeleteChannelResponse struct {
	// Spec 049 Phase 4 — soft-delete a Channel AND its chat root together (the
	// protection holds while either exists, so the address stays reserved and a
	// restore brings both back). Host memory write access required. An App's
	// default Channel is unlinked from the App. ref: its id or its address
	// (`Channel.chatRootUrn`, #1171).
	DeleteChannel bool `json:"deleteChannel"`
}

DeleteChannelResponse is returned by DeleteChannel on success.

func DeleteChannel added in v0.14.0 

func DeleteChannel(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *DeleteChannelResponse, err_ error)

func (*DeleteChannelResponse) GetDeleteChannel added in v0.14.0 

func (v *DeleteChannelResponse) GetDeleteChannel() bool

GetDeleteChannel returns DeleteChannelResponse.DeleteChannel, and is useful for accessing the field via an interface.

type DeleteEdgeResponse 

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

DeleteEdgeResponse is returned by DeleteEdge on success.

func DeleteEdge 

func DeleteEdge(
	ctx_ context.Context,
	client_ graphql.Client,
	edgeId string,
) (data_ *DeleteEdgeResponse, err_ error)

func (*DeleteEdgeResponse) GetDeleteEdge 

func (v *DeleteEdgeResponse) GetDeleteEdge() bool

GetDeleteEdge returns DeleteEdgeResponse.DeleteEdge, and is useful for accessing the field via an interface.

type DeleteMcpServerResponse added in v0.7.0 

type DeleteMcpServerResponse struct {
	// Hard-delete a registered MCP server (org ADMIN/OWNER); runs referencing its tools fail loud afterwards.
	DeleteMcpServer bool `json:"deleteMcpServer"`
}

DeleteMcpServerResponse is returned by DeleteMcpServer on success.

func DeleteMcpServer added in v0.7.0 

func DeleteMcpServer(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *DeleteMcpServerResponse, err_ error)

func (*DeleteMcpServerResponse) GetDeleteMcpServer added in v0.7.0 

func (v *DeleteMcpServerResponse) GetDeleteMcpServer() bool

GetDeleteMcpServer returns DeleteMcpServerResponse.DeleteMcpServer, and is useful for accessing the field via an interface.

type DeleteMemoryConfigTemplateResponse added in v0.18.0 

type DeleteMemoryConfigTemplateResponse struct {
	// #1325 part (c) — soft-delete a template. Configs it was applied to keep their copies.
	DeleteMemoryConfigTemplate bool `json:"deleteMemoryConfigTemplate"`
}

DeleteMemoryConfigTemplateResponse is returned by DeleteMemoryConfigTemplate on success.

func DeleteMemoryConfigTemplate added in v0.18.0 

func DeleteMemoryConfigTemplate(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	expectedRevision int,
) (data_ *DeleteMemoryConfigTemplateResponse, err_ error)

func (*DeleteMemoryConfigTemplateResponse) GetDeleteMemoryConfigTemplate added in v0.18.0 

func (v *DeleteMemoryConfigTemplateResponse) GetDeleteMemoryConfigTemplate() bool

GetDeleteMemoryConfigTemplate returns DeleteMemoryConfigTemplateResponse.DeleteMemoryConfigTemplate, and is useful for accessing the field via an interface.

type DeleteMemoryResponse 

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

DeleteMemoryResponse is returned by DeleteMemory on success.

func DeleteMemory 

func DeleteMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *DeleteMemoryResponse, err_ error)

func (*DeleteMemoryResponse) GetDeleteMemory 

func (v *DeleteMemoryResponse) GetDeleteMemory() bool

GetDeleteMemory returns DeleteMemoryResponse.DeleteMemory, and is useful for accessing the field via an interface.

type DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload added in v0.9.0 

type DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload struct {
	GranteeId string `json:"granteeId"`
	MemoryId  string `json:"memoryId"`
}

DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload includes the requested fields of the GraphQL type DeleteMemorySharePayload. The GraphQL type's documentation follows.

Return shape for deleteMemoryShare. Both fields are RESOLVED primary keys, so a caller who passed a URN / email / handle can correlate the deletion. granteeId is the caller themselves on the self-removal path.

func (*DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload) GetGranteeId added in v0.9.0 

func (v *DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload) GetGranteeId() string

GetGranteeId returns DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload.GranteeId, and is useful for accessing the field via an interface.

func (*DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload) GetMemoryId added in v0.9.0 

func (v *DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload) GetMemoryId() string

GetMemoryId returns DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload.MemoryId, and is useful for accessing the field via an interface.

type DeleteMemoryShareResponse added in v0.9.0 

type DeleteMemoryShareResponse struct {
	// 023-app-shape US3 — delete a MemoryShare. Per FR-022, revocation
	// takes effect on the next read (there's no "deactivated" state;
	// just a row delete). Renamed from revokeMemoryShare in #785.
	//
	// Caller-authority rule (#785) — principal OR self, the same shape
	// removeMemoryMember uses:
	// - The memory's principal (memory.userId) may delete ANY grantee
	// row on their memory. Idempotent: deleting a share that is
	// already gone succeeds.
	// - A GRANTEE may delete THEIR OWN row — the
	// stop-sharing-with-me / leave path. Omit granteeRef entirely and
	// the mutation targets the caller's own share.
	// - Everyone else gets FORBIDDEN.
	//
	// On the self path the SHARE ROW itself is the authorization, so that
	// path is idempotent only up to the row's lifetime: repeating a
	// successful leave answers FORBIDDEN (you already left). That is what
	// keeps every unauthorized outcome identical — a caller who is
	// neither principal nor grantee cannot tell "no such memory" from
	// "not shared with me" from "not yours", by error code or by the
	// difference between an error and a successful no-op. The same rule
	// covers the grantee reference: a non-principal caller gets FORBIDDEN
	// whether the named user exists or not, so neither memories nor
	// users can be enumerated here. (A principal, who by definition
	// already knows the memory exists, still gets NOT_FOUND for a
	// granteeRef that resolves to nobody.)
	//
	// A grantee may leave a memory whose owner has soft-deleted it (the
	// row would otherwise be stranded); the principal path still treats a
	// soft-deleted memory as FORBIDDEN.
	DeleteMemoryShare *DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload `json:"deleteMemoryShare"`
}

DeleteMemoryShareResponse is returned by DeleteMemoryShare on success.

func DeleteMemoryShare added in v0.9.0 

func DeleteMemoryShare(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	granteeRef *string,
) (data_ *DeleteMemoryShareResponse, err_ error)

hadron-server#785: renamed from revokeMemoryShare, and the authority widened from principal-only to principal-OR-self. `granteeId` is optional now — omit it and the server deletes the CALLER'S own share (leave / stop-sharing-with-me). The contract is OMITTED, not null, so the variable carries omitempty: a nil *string must drop the key rather than serialize "granteeId": null. memoryRef takes an id or a URN and is passed through WITHOUT a client-side memory(ref:) lookup — that lookup can't see a soft-deleted memory, and leaving one is exactly a case this mutation supports. #304: granteeRef is server-resolved (id / email / handle / hrn:user URN); omitted entirely it targets the caller's own share (self-removal / leave).

func (*DeleteMemoryShareResponse) GetDeleteMemoryShare added in v0.9.0 

func (v *DeleteMemoryShareResponse) GetDeleteMemoryShare() *DeleteMemoryShareDeleteMemoryShareDeleteMemorySharePayload

GetDeleteMemoryShare returns DeleteMemoryShareResponse.DeleteMemoryShare, and is useful for accessing the field via an interface.

type DeleteMemorySubscriptionResponse added in v0.7.0 

type DeleteMemorySubscriptionResponse struct {
	// Delete a cross-org Memory subscription.
	//
	// Accepts the entity's ID or URN.
	DeleteMemorySubscription bool `json:"deleteMemorySubscription"`
}

DeleteMemorySubscriptionResponse is returned by DeleteMemorySubscription on success.

func DeleteMemorySubscription added in v0.7.0 

func DeleteMemorySubscription(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	orgRef string,
) (data_ *DeleteMemorySubscriptionResponse, err_ error)

func (*DeleteMemorySubscriptionResponse) GetDeleteMemorySubscription added in v0.7.0 

func (v *DeleteMemorySubscriptionResponse) GetDeleteMemorySubscription() bool

GetDeleteMemorySubscription returns DeleteMemorySubscriptionResponse.DeleteMemorySubscription, and is useful for accessing the field via an interface.

type DeleteNodeResponse 

type DeleteNodeResponse struct {
	// Delete a node identified by 'nodeRef' (a node ID or fully-qualified URN;
	// #542). Soft-delete by default (sets deletedAt; the node disappears from
	// reads, matching the hadron_delete_node MCP tool). Pass hard: true to
	// remove the row entirely (cascades edges + NodeRevision via FK) —
	// irreversible. #391. A re-delete of an already soft-deleted node is
	// idempotent (the ref resolves through the tombstone).
	//
	// If the node has descendants (nodes under its loc prefix), a plain delete
	// REFUSES with NODE_HAS_DESCENDANTS (carrying the count) rather than silently
	// orphaning the subtree — parity with the hadron_delete_node MCP tool. Pass
	// recursive: true to delete the node's whole loc-subtree — the node at its loc
	// PLUS every descendant, matched on ':' path boundaries (so deleting 'auth'
	// does not touch 'authoring'). The subtree lives in one memory, so the single
	// write-access check covers it; 'hard' applies to the whole subtree.
	//
	// A hard delete cascades edges on both endpoints via FK. If any affected node
	// is on an edge that bridges this memory to another, the hard delete REFUSES
	// with CROSS_MEMORY_EDGES (the caller may not own the other memory) unless
	// cascadeCrossMemoryEdges: true. A non-recursive soft re-delete of an already
	// soft-deleted node is an idempotent no-op that preserves its audit stamp.
	DeleteNode bool `json:"deleteNode"`
}

DeleteNodeResponse is returned by DeleteNode on success.

func DeleteNode 

func DeleteNode(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
	hard *bool,
	recursive *bool,
) (data_ *DeleteNodeResponse, err_ error)

Soft-delete by default (sets deletedAt; recoverable via version history). hard: true removes the row entirely — cascades edges + NodeVersion, irreversible (#391). recursive: true deletes the node PLUS every descendant under its loc prefix; a plain (non-recursive) delete of a node that HAS descendants REFUSES with a typed NODE_HAS_DESCENDANTS error carrying the count (#239, server #661). Both flags are omitted when false so a soft/non-recursive delete never sends an explicit null.

func (*DeleteNodeResponse) GetDeleteNode 

func (v *DeleteNodeResponse) GetDeleteNode() bool

GetDeleteNode returns DeleteNodeResponse.DeleteNode, and is useful for accessing the field via an interface.

type DeleteNodeRevisionResponse added in v0.7.0 

type DeleteNodeRevisionResponse struct {
	// Delete a single node-revision snapshot by id (#617). Auth: the node's memory
	// write access (as restoreNodeRevision). Throws NOT_FOUND for an unknown id.
	DeleteNodeRevision bool `json:"deleteNodeRevision"`
}

DeleteNodeRevisionResponse is returned by DeleteNodeRevision on success.

func DeleteNodeRevision added in v0.7.0 

func DeleteNodeRevision(
	ctx_ context.Context,
	client_ graphql.Client,
	revisionId string,
) (data_ *DeleteNodeRevisionResponse, err_ error)

Delete one snapshot (memory-write auth; NOT_FOUND for an unknown id).

func (*DeleteNodeRevisionResponse) GetDeleteNodeRevision added in v0.7.0 

func (v *DeleteNodeRevisionResponse) GetDeleteNodeRevision() bool

GetDeleteNodeRevision returns DeleteNodeRevisionResponse.DeleteNodeRevision, and is useful for accessing the field via an interface.

type DeleteNodeRoleRuleResponse added in v0.18.0 

type DeleteNodeRoleRuleResponse struct {
	// #1325 — delete a rule by its id; expectedRevision as for updateNodeRoleRule. A LOCKED rule (#1334) is refused with RULE_LOCKED for every caller: unlock it first (unlockNodeRoleRule).
	DeleteNodeRoleRule bool `json:"deleteNodeRoleRule"`
}

DeleteNodeRoleRuleResponse is returned by DeleteNodeRoleRule on success.

func DeleteNodeRoleRule added in v0.18.0 

func DeleteNodeRoleRule(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	expectedRevision int,
) (data_ *DeleteNodeRoleRuleResponse, err_ error)

func (*DeleteNodeRoleRuleResponse) GetDeleteNodeRoleRule added in v0.18.0 

func (v *DeleteNodeRoleRuleResponse) GetDeleteNodeRoleRule() bool

GetDeleteNodeRoleRule returns DeleteNodeRoleRuleResponse.DeleteNodeRoleRule, and is useful for accessing the field via an interface.

type DeleteObjectResponse added in v0.8.0 

type DeleteObjectResponse struct {
	// Delete an object (soft by default; 'hard: true' removes the row). 'ref' is
	// the object id (or node URN). Returns true on success.
	DeleteObject bool `json:"deleteObject"`
}

DeleteObjectResponse is returned by DeleteObject on success.

func DeleteObject added in v0.8.0 

func DeleteObject(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	hard *bool,
) (data_ *DeleteObjectResponse, err_ error)

Soft-delete by default; hard: true removes the row. Omitted when false so a soft delete never sends an explicit hard: null.

func (*DeleteObjectResponse) GetDeleteObject added in v0.8.0 

func (v *DeleteObjectResponse) GetDeleteObject() bool

GetDeleteObject returns DeleteObjectResponse.DeleteObject, and is useful for accessing the field via an interface.

type DeleteOrganizationResponse added in v0.3.0 

type DeleteOrganizationResponse struct {
	// Soft-delete an Organization.
	//
	// Accepts the entity's ID or URN.
	DeleteOrganization bool `json:"deleteOrganization"`
}

DeleteOrganizationResponse is returned by DeleteOrganization on success.

func DeleteOrganization added in v0.3.0 

func DeleteOrganization(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *DeleteOrganizationResponse, err_ error)

func (*DeleteOrganizationResponse) GetDeleteOrganization added in v0.3.0 

func (v *DeleteOrganizationResponse) GetDeleteOrganization() bool

GetDeleteOrganization returns DeleteOrganizationResponse.DeleteOrganization, and is useful for accessing the field via an interface.

type DeleteRegisterEntryResponse added in v0.15.0 

type DeleteRegisterEntryResponse struct {
	// Spec 049 Phase 5 — soft-delete a row. Each owner removes its own rows; an App may remove its install-created default.
	DeleteRegisterEntry bool `json:"deleteRegisterEntry"`
}

DeleteRegisterEntryResponse is returned by DeleteRegisterEntry on success.

func DeleteRegisterEntry added in v0.15.0 

func DeleteRegisterEntry(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *DeleteRegisterEntryResponse, err_ error)

Returns a BOOLEAN: false means nothing was deleted (unknown ref, or already gone). Discarding it would report success on a failed delete.

func (*DeleteRegisterEntryResponse) GetDeleteRegisterEntry added in v0.15.0 

func (v *DeleteRegisterEntryResponse) GetDeleteRegisterEntry() bool

GetDeleteRegisterEntry returns DeleteRegisterEntryResponse.DeleteRegisterEntry, and is useful for accessing the field via an interface.

type DeleteScopeResponse added in v0.14.0 

type DeleteScopeResponse struct {
	// Spec 049 Phase 2 — soft-delete a scope you may write; its name is free again at once.
	DeleteScope bool `json:"deleteScope"`
}

DeleteScopeResponse is returned by DeleteScope on success.

func DeleteScope added in v0.14.0 

func DeleteScope(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *DeleteScopeResponse, err_ error)

Soft-delete a scope; its name is free again at once.

func (*DeleteScopeResponse) GetDeleteScope added in v0.14.0 

func (v *DeleteScopeResponse) GetDeleteScope() bool

GetDeleteScope returns DeleteScopeResponse.DeleteScope, and is useful for accessing the field via an interface.

type DeleteSecretResponse added in v0.8.0 

type DeleteSecretResponse struct {
	// Hard-delete a secret; referencing runs fail their resolution loud (or fall through the cascade) afterwards.
	DeleteSecret bool `json:"deleteSecret"`
}

DeleteSecretResponse is returned by DeleteSecret on success.

func DeleteSecret added in v0.8.0 

func DeleteSecret(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *DeleteSecretResponse, err_ error)

func (*DeleteSecretResponse) GetDeleteSecret added in v0.8.0 

func (v *DeleteSecretResponse) GetDeleteSecret() bool

GetDeleteSecret returns DeleteSecretResponse.DeleteSecret, and is useful for accessing the field via an interface.

type DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload added in v0.10.0 

type DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload struct {
	// The role slug that was retired.
	Role string `json:"role"`
	// Nodes tombstoned — the roles:<role> definition plus any sub-nodes under it
	// (a roles:<role>:notes is content OF the role and retires with it). Soft,
	// so the subtree is recoverable.
	NodesDeleted int `json:"nodesDeleted"`
}

DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload includes the requested fields of the GraphQL type DeleteTeamRolePayload. The GraphQL type's documentation follows.

Result of deleteTeamRole (#1002).

func (*DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload) GetNodesDeleted added in v0.10.0 

func (v *DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload) GetNodesDeleted() int

GetNodesDeleted returns DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload.NodesDeleted, and is useful for accessing the field via an interface.

func (*DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload) GetRole added in v0.10.0 

func (v *DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload) GetRole() string

GetRole returns DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload.Role, and is useful for accessing the field via an interface.

type DeleteTeamRoleResponse added in v0.10.0 

type DeleteTeamRoleResponse struct {
	// #1002 — retire a roles:<role> definition. Soft-deletes the role node and
	// any sub-nodes under it (roles:<role>:notes is content OF the role), so the
	// subtree is recoverable. Unknown role: WORKER_ROLE_NOT_FOUND. Same
	// authorization as createTeamRole.
	//
	// #1050: unconditional. The minted-name check, TEAM_ROLE_IN_USE, transferTo's
	// one-step supersede, the post-delete recheck and the restore compensation
	// all existed to protect the REGISTER as a ledger of which names had been
	// allocated to this role; with no register there is no ledger to protect and
	// no second write to compensate for.
	//
	// What that machinery protected is unchanged, and was never the register's
	// doing: a Worker's name is permanent per App (cor:agt:020:02, enforced by
	// workers_app_name_uniq irrespective of any role), so deleting a role can no
	// more free a taken name than it could before. Superseding a role is now
	// create-the-successor then delete-the-old; the names were never the thing
	// being moved.
	DeleteTeamRole *DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload `json:"deleteTeamRole"`
}

DeleteTeamRoleResponse is returned by DeleteTeamRole on success.

func DeleteTeamRole added in v0.10.0 

func DeleteTeamRole(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	teamAgentRef *string,
	role string,
) (data_ *DeleteTeamRoleResponse, err_ error)

The retirement (`role rm`, #441 / hadron-server#1002). Now UNCONDITIONAL: the minted-name gate and the register hand-off (transferTo) both went with the register itself (hadron-server#1050), so there is no state a successor could inherit and nothing for a bare delete to refuse over.

func (*DeleteTeamRoleResponse) GetDeleteTeamRole added in v0.10.0 

func (v *DeleteTeamRoleResponse) GetDeleteTeamRole() *DeleteTeamRoleDeleteTeamRoleDeleteTeamRolePayload

GetDeleteTeamRole returns DeleteTeamRoleResponse.DeleteTeamRole, and is useful for accessing the field via an interface.

type DeleteWorkerResponse added in v0.9.0 

type DeleteWorkerResponse struct {
	// #974 — hard-delete a NEVER-USED miscast (cor:dmo:050:11's only removal
	// escape): refused with WORKER_IN_USE unless no session was ever bound and
	// the worker's working memory holds no content. Anything with history
	// retires instead — its name is bound to that history forever. Also removes
	// the empty working memory. Same authorization as castWorker.
	DeleteWorker bool `json:"deleteWorker"`
}

DeleteWorkerResponse is returned by DeleteWorker on success.

func DeleteWorker added in v0.9.0 

func DeleteWorker(
	ctx_ context.Context,
	client_ graphql.Client,
	workerRef string,
) (data_ *DeleteWorkerResponse, err_ error)

The one removal escape (cor:dmo:050:11): hard-delete a NEVER-USED miscast. Refused WORKER_IN_USE when any session was ever bound or the working memory holds content — anything with history retires instead.

func (*DeleteWorkerResponse) GetDeleteWorker added in v0.9.0 

func (v *DeleteWorkerResponse) GetDeleteWorker() bool

GetDeleteWorker returns DeleteWorkerResponse.DeleteWorker, and is useful for accessing the field via an interface.

type EffectiveAccessEffectiveAccess added in v0.4.0 

type EffectiveAccessEffectiveAccess struct {
	User *EffectiveAccessEffectiveAccessUser `json:"user"`
	// Canonical (grammar-v2, hrn:-prefixed) URN of the resolved resource, emitted the same way the entity's own urn field emits it — so it can be fed straight back into another query or command. Two exceptions have no URN by nature: an AiServiceConfig yields its id, and a user yields hrn:user:<handle>.
	ResourceUrn string `json:"resourceUrn"`
	// memory | node | app | agent | aiServiceConfig | organization | user.
	ResourceKind string `json:"resourceKind"`
	CanRead      bool   `json:"canRead"`
	CanWrite     bool   `json:"canWrite"`
	// Manage grants / settings (admin/owner-equivalent).
	CanManage bool `json:"canManage"`
	CanDelete bool `json:"canDelete"`
	// Highest single clean role label (e.g. owner, writer, ADMIN); null when access is purely capability-based or absent.
	Role *string `json:"role"`
	// The reasons access is granted. Empty means no access. Ordered strongest-first.
	Grants []*EffectiveAccessEffectiveAccessGrantsAccessGrant `json:"grants"`
}

EffectiveAccessEffectiveAccess includes the requested fields of the GraphQL type EffectiveAccess. The GraphQL type's documentation follows.

issue #323: the effective access a single user has to a single resource, with the grants that confer it. An empty grants list (with all capabilities false and role null) is a first-class 'no access' answer, NOT an error.

func (*EffectiveAccessEffectiveAccess) GetCanDelete added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetCanDelete() bool

GetCanDelete returns EffectiveAccessEffectiveAccess.CanDelete, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetCanManage added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetCanManage() bool

GetCanManage returns EffectiveAccessEffectiveAccess.CanManage, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetCanRead added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetCanRead() bool

GetCanRead returns EffectiveAccessEffectiveAccess.CanRead, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetCanWrite added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetCanWrite() bool

GetCanWrite returns EffectiveAccessEffectiveAccess.CanWrite, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetGrants added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetGrants() []*EffectiveAccessEffectiveAccessGrantsAccessGrant

GetGrants returns EffectiveAccessEffectiveAccess.Grants, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetResourceKind added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetResourceKind() string

GetResourceKind returns EffectiveAccessEffectiveAccess.ResourceKind, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetResourceUrn added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetResourceUrn() string

GetResourceUrn returns EffectiveAccessEffectiveAccess.ResourceUrn, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetRole added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetRole() *string

GetRole returns EffectiveAccessEffectiveAccess.Role, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccess) GetUser added in v0.4.0 

func (v *EffectiveAccessEffectiveAccess) GetUser() *EffectiveAccessEffectiveAccessUser

GetUser returns EffectiveAccessEffectiveAccess.User, and is useful for accessing the field via an interface.

type EffectiveAccessEffectiveAccessGrantsAccessGrant added in v0.4.0 

type EffectiveAccessEffectiveAccessGrantsAccessGrant struct {
	Source AccessSource `json:"source"`
	// The role/level this particular grant confers.
	Role string `json:"role"`
	// Human label for the grant's origin (owning org URN, the inherited memory URN, the app URN, etc.); null when the grant has no distinct origin.
	Via *string `json:"via"`
}

EffectiveAccessEffectiveAccessGrantsAccessGrant includes the requested fields of the GraphQL type AccessGrant. The GraphQL type's documentation follows.

issue #323: one reason a subject has (or would have) access to a resource.

func (*EffectiveAccessEffectiveAccessGrantsAccessGrant) GetRole added in v0.4.0 

func (v *EffectiveAccessEffectiveAccessGrantsAccessGrant) GetRole() string

GetRole returns EffectiveAccessEffectiveAccessGrantsAccessGrant.Role, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccessGrantsAccessGrant) GetSource added in v0.4.0 

func (v *EffectiveAccessEffectiveAccessGrantsAccessGrant) GetSource() AccessSource

GetSource returns EffectiveAccessEffectiveAccessGrantsAccessGrant.Source, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccessGrantsAccessGrant) GetVia added in v0.4.0 

func (v *EffectiveAccessEffectiveAccessGrantsAccessGrant) GetVia() *string

GetVia returns EffectiveAccessEffectiveAccessGrantsAccessGrant.Via, and is useful for accessing the field via an interface.

type EffectiveAccessEffectiveAccessUser added in v0.4.0 

type EffectiveAccessEffectiveAccessUser struct {
	Id     string  `json:"id"`
	Name   *string `json:"name"`
	Email  *string `json:"email"`
	Handle *string `json:"handle"`
}

EffectiveAccessEffectiveAccessUser includes the requested fields of the GraphQL type User.

func (*EffectiveAccessEffectiveAccessUser) GetEmail added in v0.4.0 

func (v *EffectiveAccessEffectiveAccessUser) GetEmail() *string

GetEmail returns EffectiveAccessEffectiveAccessUser.Email, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccessUser) GetHandle added in v0.4.0 

func (v *EffectiveAccessEffectiveAccessUser) GetHandle() *string

GetHandle returns EffectiveAccessEffectiveAccessUser.Handle, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccessUser) GetId added in v0.4.0 

func (v *EffectiveAccessEffectiveAccessUser) GetId() string

GetId returns EffectiveAccessEffectiveAccessUser.Id, and is useful for accessing the field via an interface.

func (*EffectiveAccessEffectiveAccessUser) GetName added in v0.4.0 

func (v *EffectiveAccessEffectiveAccessUser) GetName() *string

GetName returns EffectiveAccessEffectiveAccessUser.Name, and is useful for accessing the field via an interface.

type EffectiveAccessResponse added in v0.4.0 

type EffectiveAccessResponse struct {
	// issue #323: resolve the effective access a single user has to a single
	// resource, with the grants that confer it. The authoritative backing for
	// the 'hadron access check <user> <resource>' audit command — one resolver
	// that reuses the server's authorization rules instead of re-deriving them
	// client-side.
	//
	// 'user' (the subject) accepts a User ID or a hrn:user:<handle> URN (spec
	// cor:urn:010:01). 'resource' is dispatched on URN type the same way
	// resolveUrn dispatches: a memory, node, app, agent, org, or user MUST be a
	// fully-qualified hrn:<type>: URN (a bare id is ambiguous across those kinds).
	// A bare id with no scheme prefix is treated as an AiServiceConfig id — the
	// only URN-less resource kind.
	//
	// Authorization (who may CALL this): the same visibility bar already
	// enforced on the underlying grant tables — a platform ADMIN/OWNER, an
	// ADMIN/OWNER of the resource's owning org, or (for a strict-owner memory)
	// the memory's principal. Everyone else gets FORBIDDEN, NOT a silent empty
	// result, so the command can't probe access it isn't allowed to audit.
	//
	// A subject with no access is a SUCCESS with an empty grants list (all
	// capabilities false, role null) — not NOT_FOUND. An unresolvable or
	// unknown resource ref is NOT_FOUND.
	EffectiveAccess *EffectiveAccessEffectiveAccess `json:"effectiveAccess"`
}

EffectiveAccessResponse is returned by EffectiveAccess on success.

func EffectiveAccess added in v0.4.0 

func EffectiveAccess(
	ctx_ context.Context,
	client_ graphql.Client,
	user string,
	resource string,
) (data_ *EffectiveAccessResponse, err_ error)

func (*EffectiveAccessResponse) GetEffectiveAccess added in v0.4.0 

func (v *EffectiveAccessResponse) GetEffectiveAccess() *EffectiveAccessEffectiveAccess

GetEffectiveAccess returns EffectiveAccessResponse.EffectiveAccess, and is useful for accessing the field via an interface.

type EncryptMemoryEncryptMemory added in v0.7.0 

type EncryptMemoryEncryptMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn         string `json:"urn"`
	Name        string `json:"name"`
	IsEncrypted bool   `json:"isEncrypted"`
}

EncryptMemoryEncryptMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*EncryptMemoryEncryptMemory) GetId added in v0.7.0 

func (v *EncryptMemoryEncryptMemory) GetId() string

GetId returns EncryptMemoryEncryptMemory.Id, and is useful for accessing the field via an interface.

func (*EncryptMemoryEncryptMemory) GetIsEncrypted added in v0.7.0 

func (v *EncryptMemoryEncryptMemory) GetIsEncrypted() bool

GetIsEncrypted returns EncryptMemoryEncryptMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*EncryptMemoryEncryptMemory) GetName added in v0.7.0 

func (v *EncryptMemoryEncryptMemory) GetName() string

GetName returns EncryptMemoryEncryptMemory.Name, and is useful for accessing the field via an interface.

func (*EncryptMemoryEncryptMemory) GetUrn added in v0.7.0 

func (v *EncryptMemoryEncryptMemory) GetUrn() string

GetUrn returns EncryptMemoryEncryptMemory.Urn, and is useful for accessing the field via an interface.

type EncryptMemoryResponse added in v0.7.0 

type EncryptMemoryResponse struct {
	// Convert a plaintext PRIVATE memory to encrypted (spec 041, caller-held
	// keys). Exactly one of dataKey (base64, 32 bytes) / passphrase (scrypt-
	// derived; salt + params stored on the memory, the key itself never).
	// Owner or org-App-key. All node content/abstract/data is re-written as
	// ciphertext in one transaction. One-way without the key: the server
	// cannot recover the content.
	//
	// Accepts the entity's ID or URN.
	EncryptMemory *EncryptMemoryEncryptMemory `json:"encryptMemory"`
}

EncryptMemoryResponse is returned by EncryptMemory on success.

func EncryptMemory added in v0.7.0 

func EncryptMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryId string,
	dataKey string,
) (data_ *EncryptMemoryResponse, err_ error)

Convert a plaintext memory to encrypted-at-rest (#57). One-way: the caller provides the data key and all node content/data is rewritten as ciphertext in a single transaction. There is no decrypt mutation, so the command gates like a destructive op.

func (*EncryptMemoryResponse) GetEncryptMemory added in v0.7.0 

func (v *EncryptMemoryResponse) GetEncryptMemory() *EncryptMemoryEncryptMemory

GetEncryptMemory returns EncryptMemoryResponse.EncryptMemory, and is useful for accessing the field via an interface.

type EndTeamSessionEndSession added in v0.9.0 

type EndTeamSessionEndSession struct {
	TeamSessionFields `json:"-"`
}

EndTeamSessionEndSession includes the requested fields of the GraphQL type Session. The GraphQL type's documentation follows.

A unit of work recorded against a user or App: the general row, and what the bare word "session" means throughout this schema (#1034). `type` says which kind — DEVELOPER, CHATBOT, AUTOMATION, EDGE — and `workerId` is optional.

A **worker session** is the subtype with `workerId` set: a Worker (named casting) bound to a driver, which is what makes work attributable to a teammate and what a merged PR traces back through. Binding is optional, so a list of these is not a staff view and may hold no worker sessions at all — read `workerId` per row rather than assuming either way.

A **chat session** is NOT one of these and has no row here: it is the conversation a human is in — the Claude Desktop window, the Claude Code session, the IDE chat. The two are independent and **ending one does not end the other**: a chat session that closes leaves its worker session open until endSession. Since #1114 nothing ends it for inactivity — silence is not evidence of abandonment — but it stops reading as LIVE once nobody has driven it inside its idle window, so the stale session stops blocking another bind without being ended or losing its unwritten handoff. That changes no HOLD: a human-held name stays held until explicit release, so only its holder can bind it again. Do not use "chat session" for a Chat (the agent conversation entity) — that is an **agent chat**, a third concept.

func (*EndTeamSessionEndSession) GetAgentId added in v0.9.0 

func (v *EndTeamSessionEndSession) GetAgentId() *string

GetAgentId returns EndTeamSessionEndSession.AgentId, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetAutoExpiredAt added in v0.15.0 

func (v *EndTeamSessionEndSession) GetAutoExpiredAt() *string

GetAutoExpiredAt returns EndTeamSessionEndSession.AutoExpiredAt, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetBranch added in v0.9.0 

func (v *EndTeamSessionEndSession) GetBranch() *string

GetBranch returns EndTeamSessionEndSession.Branch, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetEndedAt added in v0.9.0 

func (v *EndTeamSessionEndSession) GetEndedAt() *string

GetEndedAt returns EndTeamSessionEndSession.EndedAt, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetHost added in v0.9.0 

func (v *EndTeamSessionEndSession) GetHost() *string

GetHost returns EndTeamSessionEndSession.Host, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetId added in v0.9.0 

func (v *EndTeamSessionEndSession) GetId() string

GetId returns EndTeamSessionEndSession.Id, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetLlmModel added in v0.9.0 

func (v *EndTeamSessionEndSession) GetLlmModel() *string

GetLlmModel returns EndTeamSessionEndSession.LlmModel, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetPrNumber added in v0.9.0 

func (v *EndTeamSessionEndSession) GetPrNumber() *int

GetPrNumber returns EndTeamSessionEndSession.PrNumber, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetRepo added in v0.9.0 

func (v *EndTeamSessionEndSession) GetRepo() *string

GetRepo returns EndTeamSessionEndSession.Repo, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetStartedAt added in v0.9.0 

func (v *EndTeamSessionEndSession) GetStartedAt() string

GetStartedAt returns EndTeamSessionEndSession.StartedAt, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetTool added in v0.9.0 

func (v *EndTeamSessionEndSession) GetTool() *string

GetTool returns EndTeamSessionEndSession.Tool, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetTranscriptPath added in v0.9.0 

func (v *EndTeamSessionEndSession) GetTranscriptPath() *string

GetTranscriptPath returns EndTeamSessionEndSession.TranscriptPath, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetType added in v0.9.0 

func (v *EndTeamSessionEndSession) GetType() string

GetType returns EndTeamSessionEndSession.Type, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetUserId added in v0.9.0 

func (v *EndTeamSessionEndSession) GetUserId() *string

GetUserId returns EndTeamSessionEndSession.UserId, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetWorker added in v0.9.0 

func (v *EndTeamSessionEndSession) GetWorker() *TeamSessionFieldsWorker

GetWorker returns EndTeamSessionEndSession.Worker, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) GetWorkerId added in v0.9.0 

func (v *EndTeamSessionEndSession) GetWorkerId() *string

GetWorkerId returns EndTeamSessionEndSession.WorkerId, and is useful for accessing the field via an interface.

func (*EndTeamSessionEndSession) MarshalJSON added in v0.9.0 

func (v *EndTeamSessionEndSession) MarshalJSON() ([]byte, error)

func (*EndTeamSessionEndSession) UnmarshalJSON added in v0.9.0 

func (v *EndTeamSessionEndSession) UnmarshalJSON(b []byte) error

type EndTeamSessionResponse added in v0.9.0 

type EndTeamSessionResponse struct {
	// End a session, and — for a worker-bound one — write its closing handoff
	// (#1029). This is the CLIENT operation that ends a worker session. Since
	// #1114 it is very nearly the ONLY one: the reaper ends a session only when a
	// hard expiresAt promised at session start has passed, never for going
	// quiet. A client's chat session ending **does not end a worker session**, and
	// never reaches this server (#1034).
	//
	// It ends the SESSION, not any HOLD. Where a person bound the worker the name
	// stays theirs until explicitly released (#1050,
	// [`cor:agt:020:09`](hrn:node:hadronmemory.com:specs:cor:agt:020:09)), so
	// only that holder can bind it again. A pure App-key **bind takes no hold** —
	// which is a fact about the bind, not a promise about the worker's state when
	// this returns: an eligible user may have forced a binding meanwhile and taken
	// the name, and ending the App-key session leaves that hold and that session
	// untouched.
	//
	// Gate (#931): platform admin, the session's App, or the attributed user
	// (not via impersonation).
	//
	// `handoff` is agent-composed prose: what landed, what is open, what is
	// blocked, what the next driver should not repeat. The server owns where it
	// goes (the worker's working memory, under the `handoffs` parent, at a
	// lexically-ordered loc), so no client re-derives the convention.
	//
	// `summary` is NOT a smaller `handoff` (#1100). It sets `Session.summary`,
	// a label on the session row — readable back through `session` / `sessions`,
	// but read by no worker-continuity path, so the next driver never sees it. The
	// two sit side by side and only one of them reaches that driver, so a caller
	// writing a closing note picks by name: it is `handoff`.
	//
	// The two mistakes are not symmetric, and that is the whole hazard. Putting
	// continuity prose in `summary` succeeds, returns a normal receipt, and
	// produces NO handoff — discovered only once the context that could have
	// written one is gone, and not correctable in place, since the sequence is
	// append-only and the stint has ended (re-ending is refused). The remedy is to
	// bind again and end THAT session with the prose. Putting a label in
	// `handoff` is merely untidy: the row lacks its label and the text reaches
	// the next driver anyway.
	//
	// Written BEFORE the session ends, and a failed write REFUSES the end
	// (HANDOFF_WRITE_FAILED) rather than ending anyway: a still-bound worker is
	// recoverable — retry, or end without a handoff deliberately — while an ended
	// session whose handoff evaporated is not, because the context that composed
	// it is gone. Passing `handoff` on a session with no worker is refused rather
	// than dropped; there is no sequence to write it to.
	EndSession *EndTeamSessionEndSession `json:"endSession"`
}

EndTeamSessionResponse is returned by EndTeamSession on success.

func EndTeamSession added in v0.9.0 

func EndTeamSession(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	summary *string,
	handoff *string,
) (data_ *EndTeamSessionResponse, err_ error)

`handoff` is the #1029 CONTINUITY RECORD, and the reason this mutation is not just a state flip: agent-composed prose about what landed, what is open, what is blocked, and what the next driver should not repeat. The server owns where it goes (the worker's working memory, under `handoffs`, at a lexically-ordered loc), so the CLI composes no node and derives no convention.

It is written BEFORE the session ends, and a failed write REFUSES the end (HANDOFF_WRITE_FAILED) rather than ending anyway — a still-bound worker is recoverable, an ended session whose handoff evaporated is not, because the context that composed it is gone. Passing it on a session with no worker is refused rather than dropped: there is no sequence to write it to.

`summary` is a DIFFERENT field and the next driver never sees it (#1029 — it is the write-only field that feature was filed to fix). Both are kept because collapsing them is a decision about #1029's shape, not about this operation.

func (*EndTeamSessionResponse) GetEndSession added in v0.9.0 

func (v *EndTeamSessionResponse) GetEndSession() *EndTeamSessionEndSession

GetEndSession returns EndTeamSessionResponse.EndSession, and is useful for accessing the field via an interface.

type ExtractParentNodeToMemoryExtractParentNodeToMemory added in v0.7.0 

type ExtractParentNodeToMemoryExtractParentNodeToMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

ExtractParentNodeToMemoryExtractParentNodeToMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetClass added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetClass() MemoryClass

GetClass returns ExtractParentNodeToMemoryExtractParentNodeToMemory.Class, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetId added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetId() string

GetId returns ExtractParentNodeToMemoryExtractParentNodeToMemory.Id, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetIsEncrypted added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetIsEncrypted() bool

GetIsEncrypted returns ExtractParentNodeToMemoryExtractParentNodeToMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetMaxRevCount added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetMaxRevCount() int

GetMaxRevCount returns ExtractParentNodeToMemoryExtractParentNodeToMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetName added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetName() string

GetName returns ExtractParentNodeToMemoryExtractParentNodeToMemory.Name, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetOrganizationId added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetOrganizationId() *string

GetOrganizationId returns ExtractParentNodeToMemoryExtractParentNodeToMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetShortDescription added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetShortDescription() *string

GetShortDescription returns ExtractParentNodeToMemoryExtractParentNodeToMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetUpdatedAt added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetUpdatedAt() string

GetUpdatedAt returns ExtractParentNodeToMemoryExtractParentNodeToMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetUrn added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetUrn() string

GetUrn returns ExtractParentNodeToMemoryExtractParentNodeToMemory.Urn, and is useful for accessing the field via an interface.

func (*ExtractParentNodeToMemoryExtractParentNodeToMemory) GetVisibility added in v0.7.0 

func (v *ExtractParentNodeToMemoryExtractParentNodeToMemory) GetVisibility() *MemoryVisibility

GetVisibility returns ExtractParentNodeToMemoryExtractParentNodeToMemory.Visibility, and is useful for accessing the field via an interface.

type ExtractParentNodeToMemoryResponse added in v0.7.0 

type ExtractParentNodeToMemoryResponse struct {
	// Extract a parent node and its whole loc-subtree into a BRAND-NEW memory,
	// making the parent the new memory's root.
	//
	// The subtree is loc-prefix defined: the node at the parent's loc plus every
	// live descendant (loc starting with 'parentLoc:'). Locs are REBASED so the
	// parent becomes the root — 'findings:auth' becomes the memory slug and
	// 'findings:auth:oauth' becomes '<slug>:oauth'. Edges wholly inside the
	// subtree carry over (their loc re-derived from the rebased endpoints);
	// boundary-crossing edges and PendingEdges are dropped.
	//
	// 'parentRef' is the parent node's ID or fully-qualified URN. 'targetUrn' is
	// a fully-qualified '<root>:<slug>' URN naming the new memory (it may land in
	// a DIFFERENT org). 'move' = false (default) COPIES the subtree, leaving the
	// source intact; 'move' = true relocates it, soft-deleting the source subtree
	// (its nodes, the source memory's touching edges, and its pending edges).
	//
	// The new memory PRESERVES the source's class so an extract never widens who
	// can read the content: a member-restricted 'group' stays group, a
	// personal/private source stays owner-owned, knowledge stays knowledge.
	// Governance/config (requiresLicense, chunk dials, revision cap, acceptsUploads)
	// carries over from the source.
	//
	// Authorization: read access to the source memory (denial reads as
	// NODE_NOT_FOUND). For knowledge/group sources the caller needs the SOURCE
	// org's memory.clone grant (an export) AND the destination org's memory.create
	// (plus a non-reader membership for a cross-org drop); a personal/private
	// extract instead requires the owner to be a member of the destination org.
	// 'move' additionally requires source write access, and cannot target the
	// source root (that would empty the source — clone + deleteMemory instead).
	// Encrypted and system/app-class sources are rejected.
	//
	// v1 limitation: node content is copied verbatim — because both the slug and
	// node locs change, URN references among the moved nodes WILL break; and
	// unresolved PendingEdges within the subtree are dropped.
	ExtractParentNodeToMemory *ExtractParentNodeToMemoryExtractParentNodeToMemory `json:"extractParentNodeToMemory"`
}

ExtractParentNodeToMemoryResponse is returned by ExtractParentNodeToMemory on success.

func ExtractParentNodeToMemory added in v0.7.0 

func ExtractParentNodeToMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	parentRef string,
	targetUrn string,
	move *bool,
) (data_ *ExtractParentNodeToMemoryResponse, err_ error)

Extract a parent node + its loc-subtree into a new memory (hadron-server#637). move = false copies (source intact); move = true relocates, soft-deleting the source subtree. The default is applied server-side, so it is omitted when the --move flag is not set.

func (*ExtractParentNodeToMemoryResponse) GetExtractParentNodeToMemory added in v0.7.0 

func (v *ExtractParentNodeToMemoryResponse) GetExtractParentNodeToMemory() *ExtractParentNodeToMemoryExtractParentNodeToMemory

GetExtractParentNodeToMemory returns ExtractParentNodeToMemoryResponse.ExtractParentNodeToMemory, and is useful for accessing the field via an interface.

type FindNodesFindNodesFindNodesResult added in v0.5.0 

type FindNodesFindNodesFindNodesResult struct {
	Total *int `json:"total"`
	// Reduced-fidelity flag(s); hits are usable. May carry MULTIPLE
	// comma-separated codes (e.g. 'no_vector_index,literal_fallback') —
	// parse the set, never compare the whole string. Codes: no_vector_index,
	// embedding_unavailable, literal_fallback, and_relaxed_to_or (a bare
	// multi-term keyword query matched nothing under AND, so it was retried as
	// OR and these hits match ANY term), scope_narrowed (spec 049: the scope
	// this search ran under lists memories you cannot read; they were dropped
	// and `scope.droppedCount` says how many).
	Degraded *string                                         `json:"degraded"`
	Reason   *string                                         `json:"reason"`
	Hits     []*FindNodesFindNodesFindNodesResultHitsNodeHit `json:"hits"`
}

FindNodesFindNodesFindNodesResult includes the requested fields of the GraphQL type FindNodesResult. The GraphQL type's documentation follows.

Envelope for findNodes (cor:api:090) — the unified node list + search field (it replaced the removed nodes + nodeSearch queries). hits carry per-hit score + vector metadata; passages carry chunk-granularity results; reason/degraded surface no-index / reduced-fidelity outcomes.

func (*FindNodesFindNodesFindNodesResult) GetDegraded added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResult) GetDegraded() *string

GetDegraded returns FindNodesFindNodesFindNodesResult.Degraded, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResult) GetHits added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResult) GetHits() []*FindNodesFindNodesFindNodesResultHitsNodeHit

GetHits returns FindNodesFindNodesFindNodesResult.Hits, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResult) GetReason added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResult) GetReason() *string

GetReason returns FindNodesFindNodesFindNodesResult.Reason, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResult) GetTotal added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResult) GetTotal() *int

GetTotal returns FindNodesFindNodesFindNodesResult.Total, and is useful for accessing the field via an interface.

type FindNodesFindNodesFindNodesResultHitsNodeHit added in v0.5.0 

type FindNodesFindNodesFindNodesResultHitsNodeHit struct {
	Score *float64                                          `json:"score"`
	Node  *FindNodesFindNodesFindNodesResultHitsNodeHitNode `json:"node"`
}

FindNodesFindNodesFindNodesResultHitsNodeHit includes the requested fields of the GraphQL type NodeHit. The GraphQL type's documentation follows.

A scored node hit (cor:api:090:04). score is null for an unscored filtered list (no query).

func (*FindNodesFindNodesFindNodesResultHitsNodeHit) GetNode added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHit) GetNode() *FindNodesFindNodesFindNodesResultHitsNodeHitNode

GetNode returns FindNodesFindNodesFindNodesResultHitsNodeHit.Node, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHit) GetScore added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHit) GetScore() *float64

GetScore returns FindNodesFindNodesFindNodesResultHitsNodeHit.Score, and is useful for accessing the field via an interface.

type FindNodesFindNodesFindNodesResultHitsNodeHitNode added in v0.5.0 

type FindNodesFindNodesFindNodesResultHitsNodeHitNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role       *string          `json:"role"`
	UpdatedAt  string           `json:"updatedAt"`
	Properties *json.RawMessage `json:"properties"`
	Data       *json.RawMessage `json:"data"`
}

FindNodesFindNodesFindNodesResultHitsNodeHitNode includes the requested fields of the GraphQL type Node.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetData added in v0.14.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetData() *json.RawMessage

GetData returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Data, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetId added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetId() string

GetId returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Id, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetIsRunnable added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetIsRunnable() *bool

GetIsRunnable returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.IsRunnable, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetLoc added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetLoc() string

GetLoc returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Loc, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetMemoryId added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetMemoryId() string

GetMemoryId returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.MemoryId, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetName added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetName() string

GetName returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Name, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetNodeType added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetNodeType() string

GetNodeType returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.NodeType, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetProperties added in v0.14.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetProperties() *json.RawMessage

GetProperties returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Properties, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetRole added in v0.15.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetRole() *string

GetRole returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Role, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetSeq added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetSeq() *int

GetSeq returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Seq, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetTags added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetTags() []string

GetTags returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.Tags, and is useful for accessing the field via an interface.

func (*FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetUpdatedAt added in v0.5.0 

func (v *FindNodesFindNodesFindNodesResultHitsNodeHitNode) GetUpdatedAt() string

GetUpdatedAt returns FindNodesFindNodesFindNodesResultHitsNodeHitNode.UpdatedAt, and is useful for accessing the field via an interface.

type FindNodesMode added in v0.5.0 

type FindNodesMode string

Retrieval modes for findNodes (cor:api:090:01). keyword is stemmed FTS; vector/hybrid need the memory's vector index; regex is a POSIX pattern match. 

const (
	FindNodesModeHybrid  FindNodesMode = "hybrid"
	FindNodesModeKeyword FindNodesMode = "keyword"
	FindNodesModeRegex   FindNodesMode = "regex"
	FindNodesModeVector  FindNodesMode = "vector"
)

type FindNodesResponse added in v0.5.0 

type FindNodesResponse struct {
	// Unified node search (cor:api:090) — the single node list + retrieval
	// surface (it replaced the removed `nodes` filter/list and `nodeSearch`
	// rank queries in PR3). Omit `query` for a filtered list in deterministic
	// order (subsumes `nodes`); pass `query` to rank by `mode`
	// (keyword | vector | hybrid | regex). Lexical modes honor boolean operators
	// (`(a OR b) AND c`, quoted phrases, NOT/-) — operator words are
	// UPPERCASE-ONLY, so natural phrases like 'not sure' search literally —
	// and `fields` as a ranking weight-mask. Malformed boolean syntax
	// (unmatched parenthesis, unterminated quote) DEGRADES to a literal phrase
	// search flagged `degraded: 'literal_fallback'` instead of erroring; only
	// mode: regex fails loudly on bad syntax. `filter` is the structured, AND-combined filter context
	// (SYSTEM memory class excluded by default; explicit wins). Returns a
	// scored-hit envelope. Access-scoped identically to the per-kind node queries.
	//
	// orgId (optional) narrows the accessible scope to a single organization the
	// caller is a member of; a non-member orgId returns an empty envelope
	// (total 0, no existence disclosure). Combined with filter.isRunnable: true
	// this is the canonical "the caller's runnable task nodes in one org" query
	// (there is no separate myTasks surface — a task is simply an isRunnable node).
	FindNodes *FindNodesFindNodesFindNodesResult `json:"findNodes"`
}

FindNodesResponse is returned by FindNodes on success.

func FindNodes added in v0.5.0 

func FindNodes(
	ctx_ context.Context,
	client_ graphql.Client,
	query *string,
	mode *FindNodesMode,
	filter *NodeFilter,
	sort *NodeSort,
	sortProperty *gqltypes.NodePropertySort,
	limit *int,
	offset *int,
	withProperties bool,
	withData bool,
) (data_ *FindNodesResponse, err_ error)

Unified node list + search (cor:api:090) — the one field that supersedes the old `nodes` list and `nodeSearch`. Omit $query for a filtered list in deterministic order (subsumes `nodes`); pass $query to rank by $mode (keyword | vector | hybrid | regex). $filter is the structured, AND-combined selector context (memoryIds, locPrefix, nodeType, tags, isRunnable, …). Results are under hits[].node — never a bare array. Backs `node ls`, `node import`, `memory export`, and the `spec` reads; driven through api.FindNodes, which flattens hits→nodes and surfaces degraded/reason.

The server treats an omitted NodeFilter field as "no constraint"; nil pointers must therefore be omitted, not sent as null — hence the per-field omitempty annotations mirroring nodes.graphql's NodeInput contract. NodeWhereInput / NodePropertySort are bound to hand-authored structs (internal/api/gqltypes, wired in genqlient.yaml) whose json tags pin the omit-vs-null wire contract — genqlient's own omitempty resolution is non-deterministic for the recursive NodeWhereInput, so it can't own it.

func (*FindNodesResponse) GetFindNodes added in v0.5.0 

func (v *FindNodesResponse) GetFindNodes() *FindNodesFindNodesFindNodesResult

GetFindNodes returns FindNodesResponse.FindNodes, and is useful for accessing the field via an interface.

type FindObjectsFindObjectsObjectList added in v0.8.0 

type FindObjectsFindObjectsObjectList struct {
	Objects []json.RawMessage `json:"objects"`
	Total   *int              `json:"total"`
}

FindObjectsFindObjectsObjectList includes the requested fields of the GraphQL type ObjectList. The GraphQL type's documentation follows.

#745 — a page of objects from the object store. Each object is a flat JSON record { id, type, ...fields } (the projection of a node). 'total' is the full match count (null when unbounded).

func (*FindObjectsFindObjectsObjectList) GetObjects added in v0.8.0 

func (v *FindObjectsFindObjectsObjectList) GetObjects() []json.RawMessage

GetObjects returns FindObjectsFindObjectsObjectList.Objects, and is useful for accessing the field via an interface.

func (*FindObjectsFindObjectsObjectList) GetTotal added in v0.8.0 

func (v *FindObjectsFindObjectsObjectList) GetTotal() *int

GetTotal returns FindObjectsFindObjectsObjectList.Total, and is useful for accessing the field via an interface.

type FindObjectsResponse added in v0.8.0 

type FindObjectsResponse struct {
	// #745 — query a collection. Returns objects of the given type (the collection
	// / node objectType) in the memory, projected flat. 'match' is an equality
	// shorthand ({ field: value }) desugared to a where predicate with each field's
	// cast inferred from the memory schema; 'where' is the full #719 predicate
	// (ANDed with match); 'sort' is a single-field shorthand desugared to a
	// property-path sort.
	FindObjects *FindObjectsFindObjectsObjectList `json:"findObjects"`
}

FindObjectsResponse is returned by FindObjects on success.

func FindObjects added in v0.8.0 

func FindObjects(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	objectType string,
	match *json.RawMessage,
	where *json.RawMessage,
	sort *json.RawMessage,
	limit *int,
	offset *int,
) (data_ *FindObjectsResponse, err_ error)

Query a collection; returns { objects, total }. match/where/sort/limit/offset are optional — nil pointers omitted so an unset filter applies no constraint.

func (*FindObjectsResponse) GetFindObjects added in v0.8.0 

func (v *FindObjectsResponse) GetFindObjects() *FindObjectsFindObjectsObjectList

GetFindObjects returns FindObjectsResponse.FindObjects, and is useful for accessing the field via an interface.

type GetAgentAgent added in v0.7.0 

type GetAgentAgent struct {
	AgentFields `json:"-"`
}

GetAgentAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*GetAgentAgent) GetAiModel added in v0.7.0 

func (v *GetAgentAgent) GetAiModel() *string

GetAiModel returns GetAgentAgent.AiModel, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetAiProvider added in v0.7.0 

func (v *GetAgentAgent) GetAiProvider() *string

GetAiProvider returns GetAgentAgent.AiProvider, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetCreatedAt added in v0.7.0 

func (v *GetAgentAgent) GetCreatedAt() string

GetCreatedAt returns GetAgentAgent.CreatedAt, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetDescription added in v0.7.0 

func (v *GetAgentAgent) GetDescription() *string

GetDescription returns GetAgentAgent.Description, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetHasAiApiKey added in v0.7.0 

func (v *GetAgentAgent) GetHasAiApiKey() bool

GetHasAiApiKey returns GetAgentAgent.HasAiApiKey, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetId added in v0.7.0 

func (v *GetAgentAgent) GetId() string

GetId returns GetAgentAgent.Id, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetName added in v0.7.0 

func (v *GetAgentAgent) GetName() string

GetName returns GetAgentAgent.Name, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetOrganizationId added in v0.7.0 

func (v *GetAgentAgent) GetOrganizationId() *string

GetOrganizationId returns GetAgentAgent.OrganizationId, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetPersonaRole added in v0.9.0 

func (v *GetAgentAgent) GetPersonaRole() *string

GetPersonaRole returns GetAgentAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetSurfaces added in v0.7.0 

func (v *GetAgentAgent) GetSurfaces() []string

GetSurfaces returns GetAgentAgent.Surfaces, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetSystemMemoryId added in v0.7.0 

func (v *GetAgentAgent) GetSystemMemoryId() *string

GetSystemMemoryId returns GetAgentAgent.SystemMemoryId, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetSystemPrompt added in v0.7.0 

func (v *GetAgentAgent) GetSystemPrompt() *string

GetSystemPrompt returns GetAgentAgent.SystemPrompt, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetType added in v0.7.0 

func (v *GetAgentAgent) GetType() AgentType

GetType returns GetAgentAgent.Type, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetUrn added in v0.7.0 

func (v *GetAgentAgent) GetUrn() string

GetUrn returns GetAgentAgent.Urn, and is useful for accessing the field via an interface.

func (*GetAgentAgent) GetVisibility added in v0.7.0 

func (v *GetAgentAgent) GetVisibility() AgentVisibility

GetVisibility returns GetAgentAgent.Visibility, and is useful for accessing the field via an interface.

func (*GetAgentAgent) MarshalJSON added in v0.7.0 

func (v *GetAgentAgent) MarshalJSON() ([]byte, error)

func (*GetAgentAgent) UnmarshalJSON added in v0.7.0 

func (v *GetAgentAgent) UnmarshalJSON(b []byte) error

type GetAgentResponse added in v0.7.0 

type GetAgentResponse struct {
	// The uniform single-agent read (#473) — the first top-level Agent query;
	// previously Agents were reachable only via Organization.agents /
	// App.agents nesting. Gate mirrors resolveUrn's agent branch: member of
	// the Agent's org or platform ADMIN/OWNER; denied throws Forbidden,
	// missing is null.
	//
	// 'ref' accepts the entity's ID or URN.
	Agent *GetAgentAgent `json:"agent"`
}

GetAgentResponse is returned by GetAgent on success.

func GetAgent added in v0.7.0 

func GetAgent(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetAgentResponse, err_ error)

func (*GetAgentResponse) GetAgent added in v0.7.0 

func (v *GetAgentResponse) GetAgent() *GetAgentAgent

GetAgent returns GetAgentResponse.Agent, and is useful for accessing the field via an interface.

type GetAppSharedMemoryApp added in v0.9.0 

type GetAppSharedMemoryApp struct {
	Id string `json:"id"`
	// The App's SHARED app-class memory (#965) — the team space the shared/team
	// chat and the worklog live in, provisioned at install since #951. This is
	// the App → memory hop clients need to default a team-memory argument
	// (hadron-cli#399) instead of scanning every readable memory for
	// Memory.appId. Read-only resolution, never provisions: the memory holding
	// the App's 'worklog' root wins (the ledger home — oldest, mirroring the
	// worklog locator), else the oldest agent-keyed shared row
	// (sharedMemoryOfAgentId set; Worker working memories are also app-class
	// rows under this App and are never this answer). Null when nothing has
	// provisioned a shared memory yet (an App predating #951 with no team
	// activity), or when the caller cannot read the memory record (the ordinary
	// record read gate — denied and missing are indistinguishable).
	SharedMemory *GetAppSharedMemoryAppSharedMemory `json:"sharedMemory"`
}

GetAppSharedMemoryApp includes the requested fields of the GraphQL type App. The GraphQL type's documentation follows.

A runtime caller identity owned by exactly one Organization or User. It owns long-lived App Keys and installs Agents through the AppAgent N:M join: one App may install many Agents, and one Agent may be installed in many Apps. The singular agentId / agent fields below are soft-deprecated convenience reads of the first install, not a direct foreign key.

func (*GetAppSharedMemoryApp) GetId added in v0.9.0 

func (v *GetAppSharedMemoryApp) GetId() string

GetId returns GetAppSharedMemoryApp.Id, and is useful for accessing the field via an interface.

func (*GetAppSharedMemoryApp) GetSharedMemory added in v0.9.0 

func (v *GetAppSharedMemoryApp) GetSharedMemory() *GetAppSharedMemoryAppSharedMemory

GetSharedMemory returns GetAppSharedMemoryApp.SharedMemory, and is useful for accessing the field via an interface.

type GetAppSharedMemoryAppSharedMemory added in v0.9.0 

type GetAppSharedMemoryAppSharedMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn string `json:"urn"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// #725 — opt-in per-memory property schema (declared collections + typed fields). NULL = unstructured. Authored via updateMemory; well-formedness validated server-side.
	Schema *json.RawMessage `json:"schema"`
}

GetAppSharedMemoryAppSharedMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*GetAppSharedMemoryAppSharedMemory) GetClass added in v0.9.0 

func (v *GetAppSharedMemoryAppSharedMemory) GetClass() MemoryClass

GetClass returns GetAppSharedMemoryAppSharedMemory.Class, and is useful for accessing the field via an interface.

func (*GetAppSharedMemoryAppSharedMemory) GetId added in v0.9.0 

func (v *GetAppSharedMemoryAppSharedMemory) GetId() string

GetId returns GetAppSharedMemoryAppSharedMemory.Id, and is useful for accessing the field via an interface.

func (*GetAppSharedMemoryAppSharedMemory) GetSchema added in v0.9.0 

func (v *GetAppSharedMemoryAppSharedMemory) GetSchema() *json.RawMessage

GetSchema returns GetAppSharedMemoryAppSharedMemory.Schema, and is useful for accessing the field via an interface.

func (*GetAppSharedMemoryAppSharedMemory) GetUrn added in v0.9.0 

func (v *GetAppSharedMemoryAppSharedMemory) GetUrn() string

GetUrn returns GetAppSharedMemoryAppSharedMemory.Urn, and is useful for accessing the field via an interface.

type GetAppSharedMemoryResponse added in v0.9.0 

type GetAppSharedMemoryResponse struct {
	// Fetch an App (member of the App's org, or platform ADMIN — the myApps
	// exposure bar; #473 relaxed this from org ADMIN for read parity with the
	// list).
	//
	// 'ref' accepts the entity's ID or URN.
	App *GetAppSharedMemoryApp `json:"app"`
}

GetAppSharedMemoryResponse is returned by GetAppSharedMemory on success.

func GetAppSharedMemory added in v0.9.0 

func GetAppSharedMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
) (data_ *GetAppSharedMemoryResponse, err_ error)

#400: `team init --app` — the App resolves its own team shared memory (hadron-server#965: read-only, never provisions; the memory holding the App's worklog root wins, mirroring the worklog locator). The schema rides along so init can keep its three-value status contract (created / updated / unchanged) without the caller naming the memory.

func (*GetAppSharedMemoryResponse) GetApp added in v0.9.0 

func (v *GetAppSharedMemoryResponse) GetApp() *GetAppSharedMemoryApp

GetApp returns GetAppSharedMemoryResponse.App, and is useful for accessing the field via an interface.

type GetBoundSessionLivenessResponse added in v0.18.0 

type GetBoundSessionLivenessResponse struct {
	Session *GetBoundSessionLivenessSession `json:"session"`
}

GetBoundSessionLivenessResponse is returned by GetBoundSessionLiveness on success.

func GetBoundSessionLiveness added in v0.18.0 

func GetBoundSessionLiveness(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *GetBoundSessionLivenessResponse, err_ error)

#791: the same-worktree binding guard needs the SERVER'S derived liveness for this exact session, not endedAt (an open session may have lapsed) and not Worker.hasLiveSession (another worktree may be driving a different session). Keep isLive out of GetTeamSession and TeamSessionFields so older servers can still run the ordinary session reads; validation refusal here means unknown.

func (*GetBoundSessionLivenessResponse) GetSession added in v0.18.0 

func (v *GetBoundSessionLivenessResponse) GetSession() *GetBoundSessionLivenessSession

GetSession returns GetBoundSessionLivenessResponse.Session, and is useful for accessing the field via an interface.

type GetBoundSessionLivenessSession added in v0.18.0 

type GetBoundSessionLivenessSession struct {
	Id        string  `json:"id"`
	StartedAt string  `json:"startedAt"`
	EndedAt   *string `json:"endedAt"`
	// hadron-cli#791 / cor:agt:020:11: whether THIS session is live: not ended,
	// AND driven inside its type's idle window (activity is the latest of
	// startedAt, the heartbeat updatedAt, and the latest attributed usage
	// event, capped at endedAt). The same derived predicate as startSession's
	// WORKER_TAKEN gate and Worker.hasLiveSession, so the three always agree.
	// An open session that is not live has LAPSED: nobody drove it inside the
	// window, so another driver may bind its worker; it is not ended, and can
	// still be ended with a handoff. False for an ended or deleted session.
	IsLive bool `json:"isLive"`
}

GetBoundSessionLivenessSession includes the requested fields of the GraphQL type Session. The GraphQL type's documentation follows.

A unit of work recorded against a user or App: the general row, and what the bare word "session" means throughout this schema (#1034). `type` says which kind — DEVELOPER, CHATBOT, AUTOMATION, EDGE — and `workerId` is optional.

A **worker session** is the subtype with `workerId` set: a Worker (named casting) bound to a driver, which is what makes work attributable to a teammate and what a merged PR traces back through. Binding is optional, so a list of these is not a staff view and may hold no worker sessions at all — read `workerId` per row rather than assuming either way.

A **chat session** is NOT one of these and has no row here: it is the conversation a human is in — the Claude Desktop window, the Claude Code session, the IDE chat. The two are independent and **ending one does not end the other**: a chat session that closes leaves its worker session open until endSession. Since #1114 nothing ends it for inactivity — silence is not evidence of abandonment — but it stops reading as LIVE once nobody has driven it inside its idle window, so the stale session stops blocking another bind without being ended or losing its unwritten handoff. That changes no HOLD: a human-held name stays held until explicit release, so only its holder can bind it again. Do not use "chat session" for a Chat (the agent conversation entity) — that is an **agent chat**, a third concept.

func (*GetBoundSessionLivenessSession) GetEndedAt added in v0.18.0 

func (v *GetBoundSessionLivenessSession) GetEndedAt() *string

GetEndedAt returns GetBoundSessionLivenessSession.EndedAt, and is useful for accessing the field via an interface.

func (*GetBoundSessionLivenessSession) GetId added in v0.18.0 

func (v *GetBoundSessionLivenessSession) GetId() string

GetId returns GetBoundSessionLivenessSession.Id, and is useful for accessing the field via an interface.

func (*GetBoundSessionLivenessSession) GetIsLive added in v0.18.0 

func (v *GetBoundSessionLivenessSession) GetIsLive() bool

GetIsLive returns GetBoundSessionLivenessSession.IsLive, and is useful for accessing the field via an interface.

func (*GetBoundSessionLivenessSession) GetStartedAt added in v0.18.0 

func (v *GetBoundSessionLivenessSession) GetStartedAt() string

GetStartedAt returns GetBoundSessionLivenessSession.StartedAt, and is useful for accessing the field via an interface.

type GetChannelChannel added in v0.14.0 

type GetChannelChannel struct {
	ChannelFields `json:"-"`
	ChannelMemory `json:"-"`
}

GetChannelChannel includes the requested fields of the GraphQL type Channel. The GraphQL type's documentation follows.

A CHANNEL (spec 049, D-2026-09-13-006): a durable, ordered message stream hosted in ONE memory at ONE reserved address, server-ordered and server-attributed — a platform entity, created one-to-one with its chat root. Creating it RESERVES and PROTECTS the address: generic node writes under it are refused (LOC_PROTECTED); its own operations (createTeamChatMessage, hadron_team_chat_post) are the only writers. The audience is the host memory's (cor:acl:030:01) — a Channel has no access layer of its own. `lastSeq` / `lastMessageAt` are the platform-maintained watermark.

func (*GetChannelChannel) GetChatRootNodeId added in v0.14.0 

func (v *GetChannelChannel) GetChatRootNodeId() string

GetChatRootNodeId returns GetChannelChannel.ChatRootNodeId, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetChatRootUrn added in v0.14.0 

func (v *GetChannelChannel) GetChatRootUrn() *string

GetChatRootUrn returns GetChannelChannel.ChatRootUrn, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetCreatedAt added in v0.14.0 

func (v *GetChannelChannel) GetCreatedAt() string

GetCreatedAt returns GetChannelChannel.CreatedAt, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetDescription added in v0.14.0 

func (v *GetChannelChannel) GetDescription() *string

GetDescription returns GetChannelChannel.Description, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetId added in v0.14.0 

func (v *GetChannelChannel) GetId() string

GetId returns GetChannelChannel.Id, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetKind added in v0.14.0 

func (v *GetChannelChannel) GetKind() ChannelKind

GetKind returns GetChannelChannel.Kind, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetLastMessageAt added in v0.14.0 

func (v *GetChannelChannel) GetLastMessageAt() *string

GetLastMessageAt returns GetChannelChannel.LastMessageAt, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetLastSeq added in v0.14.0 

func (v *GetChannelChannel) GetLastSeq() int

GetLastSeq returns GetChannelChannel.LastSeq, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetLoc added in v0.14.0 

func (v *GetChannelChannel) GetLoc() string

GetLoc returns GetChannelChannel.Loc, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetMemory added in v0.14.0 

func (v *GetChannelChannel) GetMemory() *ChannelMemoryMemory

GetMemory returns GetChannelChannel.Memory, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetMemoryId added in v0.14.0 

func (v *GetChannelChannel) GetMemoryId() string

GetMemoryId returns GetChannelChannel.MemoryId, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetName added in v0.14.0 

func (v *GetChannelChannel) GetName() string

GetName returns GetChannelChannel.Name, and is useful for accessing the field via an interface.

func (*GetChannelChannel) GetUpdatedAt added in v0.14.0 

func (v *GetChannelChannel) GetUpdatedAt() *string

GetUpdatedAt returns GetChannelChannel.UpdatedAt, and is useful for accessing the field via an interface.

func (*GetChannelChannel) MarshalJSON added in v0.14.0 

func (v *GetChannelChannel) MarshalJSON() ([]byte, error)

func (*GetChannelChannel) UnmarshalJSON added in v0.14.0 

func (v *GetChannelChannel) UnmarshalJSON(b []byte) error

type GetChannelResponse added in v0.14.0 

type GetChannelResponse struct {
	// Spec 049 Phase 4 — the uniform single-Channel read. 'ref' is the Channel's
	// id or its ADDRESS — the chat root's node URN, which is `Channel.chatRootUrn`
	// and what `createChannel(memoryRef, loc)` composes to (#1171). Null when
	// missing, when the ref names nothing, OR when you may not read its host
	// memory — identically, so this is never an existence oracle.
	Channel *GetChannelChannel `json:"channel"`
}

GetChannelResponse is returned by GetChannel on success.

func GetChannel added in v0.14.0 

func GetChannel(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetChannelResponse, err_ error)

Single-Channel read. `ref` is the id OR the address; the server resolves both.

Returns null when the Channel does not exist, when the ref names nothing, AND when the caller may not read its host memory — identically and on purpose, so it is "never an existence oracle" in the server's own words. Callers render ONE message covering all three and must not infer not-found from the null.

func (*GetChannelResponse) GetChannel added in v0.14.0 

func (v *GetChannelResponse) GetChannel() *GetChannelChannel

GetChannel returns GetChannelResponse.Channel, and is useful for accessing the field via an interface.

type GetInvitationInvitationPublicInvitation added in v0.18.0 

type GetInvitationInvitationPublicInvitation struct {
	MemberRole      Role                                                 `json:"memberRole"`
	MaxActivations  *int                                                 `json:"maxActivations"`
	ActivationCount int                                                  `json:"activationCount"`
	ExpiresAt       *string                                              `json:"expiresAt"`
	Sender          *GetInvitationInvitationPublicInvitationSender       `json:"sender"`
	Organization    *GetInvitationInvitationPublicInvitationOrganization `json:"organization"`
}

GetInvitationInvitationPublicInvitation includes the requested fields of the GraphQL type PublicInvitation. The GraphQL type's documentation follows.

The invite-page view available to anyone holding the invitation slug.

func (*GetInvitationInvitationPublicInvitation) GetActivationCount added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitation) GetActivationCount() int

GetActivationCount returns GetInvitationInvitationPublicInvitation.ActivationCount, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationPublicInvitation) GetExpiresAt added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitation) GetExpiresAt() *string

GetExpiresAt returns GetInvitationInvitationPublicInvitation.ExpiresAt, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationPublicInvitation) GetMaxActivations added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitation) GetMaxActivations() *int

GetMaxActivations returns GetInvitationInvitationPublicInvitation.MaxActivations, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationPublicInvitation) GetMemberRole added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitation) GetMemberRole() Role

GetMemberRole returns GetInvitationInvitationPublicInvitation.MemberRole, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationPublicInvitation) GetOrganization added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitation) GetOrganization() *GetInvitationInvitationPublicInvitationOrganization

GetOrganization returns GetInvitationInvitationPublicInvitation.Organization, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationPublicInvitation) GetSender added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitation) GetSender() *GetInvitationInvitationPublicInvitationSender

GetSender returns GetInvitationInvitationPublicInvitation.Sender, and is useful for accessing the field via an interface.

type GetInvitationInvitationPublicInvitationOrganization added in v0.18.0 

type GetInvitationInvitationPublicInvitationOrganization struct {
	Name string `json:"name"`
}

GetInvitationInvitationPublicInvitationOrganization includes the requested fields of the GraphQL type PublicInvitationOrganization. The GraphQL type's documentation follows.

Only the organization display name needed on the invite page.

func (*GetInvitationInvitationPublicInvitationOrganization) GetName added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitationOrganization) GetName() string

GetName returns GetInvitationInvitationPublicInvitationOrganization.Name, and is useful for accessing the field via an interface.

type GetInvitationInvitationPublicInvitationSender added in v0.18.0 

type GetInvitationInvitationPublicInvitationSender struct {
	Name           *string `json:"name"`
	GithubUsername *string `json:"githubUsername"`
}

GetInvitationInvitationPublicInvitationSender includes the requested fields of the GraphQL type PublicInvitationSender. The GraphQL type's documentation follows.

Only the sender display fields needed on the invite page.

func (*GetInvitationInvitationPublicInvitationSender) GetGithubUsername added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitationSender) GetGithubUsername() *string

GetGithubUsername returns GetInvitationInvitationPublicInvitationSender.GithubUsername, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationPublicInvitationSender) GetName added in v0.18.0 

func (v *GetInvitationInvitationPublicInvitationSender) GetName() *string

GetName returns GetInvitationInvitationPublicInvitationSender.Name, and is useful for accessing the field via an interface.

type GetInvitationResponse added in v0.7.0 

type GetInvitationResponse struct {
	// Invitation lookup (public to the slug holder). Returns only invite-page
	// display fields; accepting the slug still performs its own authorization.
	Invitation *GetInvitationInvitationPublicInvitation `json:"invitation"`
}

GetInvitationResponse is returned by GetInvitation on success.

func GetInvitation added in v0.7.0 

func GetInvitation(
	ctx_ context.Context,
	client_ graphql.Client,
	slug string,
) (data_ *GetInvitationResponse, err_ error)

Public to the invitation-slug holder. Select only fields shared by the legacy UserInvitation and the sanitized PublicInvitation (#1525), so the command can ship before either server version deploys.

func (*GetInvitationResponse) GetInvitation added in v0.7.0 

func (v *GetInvitationResponse) GetInvitation() *GetInvitationInvitationPublicInvitation

GetInvitation returns GetInvitationResponse.Invitation, and is useful for accessing the field via an interface.

type GetMemoryMemory 

type GetMemoryMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	Description      *string `json:"description"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	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"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int `json:"maxRevCount"`
	// Free-form structured metadata bag (client-defined JSON, no server-side
	// semantics). Null when unset. Settable via createMemory / updateMemory.
	Data *json.RawMessage `json:"data"`
	// #725 — opt-in per-memory property schema (declared collections + typed fields). NULL = unstructured. Authored via updateMemory; well-formedness validated server-side.
	Schema    *json.RawMessage `json:"schema"`
	CreatedAt string           `json:"createdAt"`
	UpdatedAt string           `json:"updatedAt"`
}

GetMemoryMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*GetMemoryMemory) GetClass 

func (v *GetMemoryMemory) GetClass() MemoryClass

GetClass returns GetMemoryMemory.Class, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetCreatedAt 

func (v *GetMemoryMemory) GetCreatedAt() string

GetCreatedAt returns GetMemoryMemory.CreatedAt, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetData added in v0.2.0 

func (v *GetMemoryMemory) GetData() *json.RawMessage

GetData returns GetMemoryMemory.Data, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetDescription 

func (v *GetMemoryMemory) GetDescription() *string

GetDescription returns GetMemoryMemory.Description, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetId 

func (v *GetMemoryMemory) GetId() string

GetId returns GetMemoryMemory.Id, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetIsEncrypted 

func (v *GetMemoryMemory) GetIsEncrypted() bool

GetIsEncrypted returns GetMemoryMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetMaxRevCount added in v0.7.0 

func (v *GetMemoryMemory) GetMaxRevCount() int

GetMaxRevCount returns GetMemoryMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetName 

func (v *GetMemoryMemory) GetName() string

GetName returns GetMemoryMemory.Name, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetOrganizationId 

func (v *GetMemoryMemory) GetOrganizationId() *string

GetOrganizationId returns GetMemoryMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetSchema added in v0.8.0 

func (v *GetMemoryMemory) GetSchema() *json.RawMessage

GetSchema returns GetMemoryMemory.Schema, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetShortDescription 

func (v *GetMemoryMemory) GetShortDescription() *string

GetShortDescription returns GetMemoryMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetSource 

func (v *GetMemoryMemory) GetSource() *string

GetSource returns GetMemoryMemory.Source, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetSyncStatus 

func (v *GetMemoryMemory) GetSyncStatus() SyncStatus

GetSyncStatus returns GetMemoryMemory.SyncStatus, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetTags 

func (v *GetMemoryMemory) GetTags() []string

GetTags returns GetMemoryMemory.Tags, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetUpdatedAt 

func (v *GetMemoryMemory) GetUpdatedAt() string

GetUpdatedAt returns GetMemoryMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetUrn 

func (v *GetMemoryMemory) GetUrn() string

GetUrn returns GetMemoryMemory.Urn, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetVectorIndexEnabled 

func (v *GetMemoryMemory) GetVectorIndexEnabled() bool

GetVectorIndexEnabled returns GetMemoryMemory.VectorIndexEnabled, and is useful for accessing the field via an interface.

func (*GetMemoryMemory) GetVisibility 

func (v *GetMemoryMemory) GetVisibility() *MemoryVisibility

GetVisibility returns GetMemoryMemory.Visibility, and is useful for accessing the field via an interface.

type GetMemoryResponse 

type GetMemoryResponse struct {
	// Fetch a single Memory (org member, shared-read gate, or platform ADMIN).
	// Missing and unreadable refs both return null without an error, so a caller
	// cannot use this field to test whether a private memory exists. Malformed
	// refs still fail as caller errors, and operational faults still propagate.
	//
	// 'ref' accepts the entity's ID or URN.
	Memory *GetMemoryMemory `json:"memory"`
}

GetMemoryResponse is returned by GetMemory on success.

func GetMemory 

func GetMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetMemoryResponse, err_ error)

memory(ref:) accepts the memory's PK id or URN (hadron-server#473).

func (*GetMemoryResponse) GetMemory 

func (v *GetMemoryResponse) GetMemory() *GetMemoryMemory

GetMemory returns GetMemoryResponse.Memory, and is useful for accessing the field via an interface.

type GetNodeNode added in v0.5.1 

type GetNodeNode struct {
	Id string `json:"id"`
	// Fully-qualified node URN (hrn:node:<root>:<memory>:<loc>), composed server-side from the node's memory URN + loc (#481). Carried by every Node-returning surface (findNodes, node, appNodes, nodeBatch, mutation returns).
	Urn string `json:"urn"`
	// #881 — the portal URL that opens this node, built server-side so no client
	// ever has to construct one (constructing means guessing which URN spelling
	// the /app/u/<urn> route resolves, and the legacy '::' forms in circulation
	// make that guess wrong). Form: <portal-origin>/app/u/<urn>, the portal's
	// stable URN-alias route. NULL when the deployment has no portal origin
	// configured (FRONTEND_URL) — a link to the wrong host is worse than none, so
	// clients render the field only when present.
	PortalUrl   *string `json:"portalUrl"`
	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 hadron_get_node via the contentScope parameter. hadron_find_nodes preview surfacing ships in spec 031 US2 — not yet live. Never surfaced in hadron_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: the abstract may not reflect current content when the two differ, OR when this is NULL on a node that has both an abstract and content (#1128 — an abstract written before the body existed was never fingerprinted, so it has never been checked against it; that reads as unverified, not as verified). NULL is only a clean state when the node has no abstract, or no content for the abstract to describe. Note restoreNodeRevision restores this field verbatim, so restoring a snapshot taken while it was NULL reinstates the unverified state — correctly, since that abstract has never been checked against the restored content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string `json:"abstractOriginHash"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string `json:"nodeType"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role *string `json:"role"`
	// #725 — the COLLECTION discriminator: which domain object this node is an
	// instance of, e.g. "competitor" / "insight". Validated against the memory's
	// property schema when it has one. NULL for an ordinary node.
	//
	// NOT 'nodeType' (the platform-kind axis, which drives retrieval) and NOT
	// 'role' (what the node is for; role can be filtered explicitly but does not
	// change default ranking or rendering).
	ObjectType *string          `json:"objectType"`
	Tags       []string         `json:"tags"`
	Content    *string          `json:"content"`
	Data       *json.RawMessage `json:"data"`
	Properties *json.RawMessage `json:"properties"`
	Seq        *int             `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable    *bool                           `json:"isRunnable"`
	CreatedAt     string                          `json:"createdAt"`
	UpdatedAt     string                          `json:"updatedAt"`
	OutgoingEdges []*GetNodeNodeOutgoingEdgesEdge `json:"outgoingEdges"`
	IncomingEdges []*GetNodeNodeIncomingEdgesEdge `json:"incomingEdges"`
}

GetNodeNode includes the requested fields of the GraphQL type Node.

func (*GetNodeNode) GetAbstract added in v0.5.1 

func (v *GetNodeNode) GetAbstract() *string

GetAbstract returns GetNodeNode.Abstract, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetAbstractOriginHash added in v0.5.1 

func (v *GetNodeNode) GetAbstractOriginHash() *string

GetAbstractOriginHash returns GetNodeNode.AbstractOriginHash, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetContent added in v0.5.1 

func (v *GetNodeNode) GetContent() *string

GetContent returns GetNodeNode.Content, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetCreatedAt added in v0.5.1 

func (v *GetNodeNode) GetCreatedAt() string

GetCreatedAt returns GetNodeNode.CreatedAt, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetData added in v0.5.1 

func (v *GetNodeNode) GetData() *json.RawMessage

GetData returns GetNodeNode.Data, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetDescription added in v0.5.1 

func (v *GetNodeNode) GetDescription() *string

GetDescription returns GetNodeNode.Description, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetId added in v0.5.1 

func (v *GetNodeNode) GetId() string

GetId returns GetNodeNode.Id, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetIncomingEdges added in v0.5.1 

func (v *GetNodeNode) GetIncomingEdges() []*GetNodeNodeIncomingEdgesEdge

GetIncomingEdges returns GetNodeNode.IncomingEdges, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetIsRunnable added in v0.5.1 

func (v *GetNodeNode) GetIsRunnable() *bool

GetIsRunnable returns GetNodeNode.IsRunnable, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetLoc added in v0.5.1 

func (v *GetNodeNode) GetLoc() string

GetLoc returns GetNodeNode.Loc, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetMemoryId added in v0.5.1 

func (v *GetNodeNode) GetMemoryId() string

GetMemoryId returns GetNodeNode.MemoryId, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetName added in v0.5.1 

func (v *GetNodeNode) GetName() string

GetName returns GetNodeNode.Name, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetNodeType added in v0.5.1 

func (v *GetNodeNode) GetNodeType() string

GetNodeType returns GetNodeNode.NodeType, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetObjectType added in v0.8.0 

func (v *GetNodeNode) GetObjectType() *string

GetObjectType returns GetNodeNode.ObjectType, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetOutgoingEdges added in v0.5.1 

func (v *GetNodeNode) GetOutgoingEdges() []*GetNodeNodeOutgoingEdgesEdge

GetOutgoingEdges returns GetNodeNode.OutgoingEdges, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetPortalUrl added in v0.12.0 

func (v *GetNodeNode) GetPortalUrl() *string

GetPortalUrl returns GetNodeNode.PortalUrl, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetProperties added in v0.8.0 

func (v *GetNodeNode) GetProperties() *json.RawMessage

GetProperties returns GetNodeNode.Properties, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetRole added in v0.14.0 

func (v *GetNodeNode) GetRole() *string

GetRole returns GetNodeNode.Role, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetSeq added in v0.5.1 

func (v *GetNodeNode) GetSeq() *int

GetSeq returns GetNodeNode.Seq, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetTags added in v0.5.1 

func (v *GetNodeNode) GetTags() []string

GetTags returns GetNodeNode.Tags, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetUpdatedAt added in v0.5.1 

func (v *GetNodeNode) GetUpdatedAt() string

GetUpdatedAt returns GetNodeNode.UpdatedAt, and is useful for accessing the field via an interface.

func (*GetNodeNode) GetUrn added in v0.12.0 

func (v *GetNodeNode) GetUrn() string

GetUrn returns GetNodeNode.Urn, and is useful for accessing the field via an interface.

type GetNodeNodeIncomingEdgesEdge added in v0.5.1 

type GetNodeNodeIncomingEdgesEdge struct {
	Id string `json:"id"`
	// Free-form relationship name (e.g. imports, depends_on). Optional since
	// spec 037 — loc is the identity. (Was the required 'label'.)
	Name *string `json:"name"`
	// Colon-delimited path within the (source node's) memory — the edge's
	// identity and the suffix of its URN hrn:edge:<root>:<memory>:<loc>.
	Loc string `json:"loc"`
	// If true, this edge can be executed/run (task automation, conversation
	// transitions). Mirrors Node.isRunnable.
	IsRunnable *bool `json:"isRunnable"`
	// Resolution-order hook (lower = earlier; default 0). When two edges
	// share a priority, fall back to insertion order.
	Priority int `json:"priority"`
	// The source node. NULLABLE (#781): null when the caller cannot read the source node's memory — a cross-memory edge (e.g. reached via incomingEdges) must not expose an endpoint in a memory the caller can't read. For a same-memory edge the caller can already see, this is always present.
	Source *GetNodeNodeIncomingEdgesEdgeSourceNode `json:"source"`
}

GetNodeNodeIncomingEdgesEdge includes the requested fields of the GraphQL type Edge.

func (*GetNodeNodeIncomingEdgesEdge) GetId added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdge) GetId() string

GetId returns GetNodeNodeIncomingEdgesEdge.Id, and is useful for accessing the field via an interface.

func (*GetNodeNodeIncomingEdgesEdge) GetIsRunnable added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdge) GetIsRunnable() *bool

GetIsRunnable returns GetNodeNodeIncomingEdgesEdge.IsRunnable, and is useful for accessing the field via an interface.

func (*GetNodeNodeIncomingEdgesEdge) GetLoc added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdge) GetLoc() string

GetLoc returns GetNodeNodeIncomingEdgesEdge.Loc, and is useful for accessing the field via an interface.

func (*GetNodeNodeIncomingEdgesEdge) GetName added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdge) GetName() *string

GetName returns GetNodeNodeIncomingEdgesEdge.Name, and is useful for accessing the field via an interface.

func (*GetNodeNodeIncomingEdgesEdge) GetPriority added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdge) GetPriority() int

GetPriority returns GetNodeNodeIncomingEdgesEdge.Priority, and is useful for accessing the field via an interface.

func (*GetNodeNodeIncomingEdgesEdge) GetSource added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdge) GetSource() *GetNodeNodeIncomingEdgesEdgeSourceNode

GetSource returns GetNodeNodeIncomingEdgesEdge.Source, and is useful for accessing the field via an interface.

type GetNodeNodeIncomingEdgesEdgeSourceNode added in v0.5.1 

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

GetNodeNodeIncomingEdgesEdgeSourceNode includes the requested fields of the GraphQL type Node.

func (*GetNodeNodeIncomingEdgesEdgeSourceNode) GetId added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdgeSourceNode) GetId() string

GetId returns GetNodeNodeIncomingEdgesEdgeSourceNode.Id, and is useful for accessing the field via an interface.

func (*GetNodeNodeIncomingEdgesEdgeSourceNode) GetLoc added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdgeSourceNode) GetLoc() string

GetLoc returns GetNodeNodeIncomingEdgesEdgeSourceNode.Loc, and is useful for accessing the field via an interface.

func (*GetNodeNodeIncomingEdgesEdgeSourceNode) GetMemoryId added in v0.5.1 

func (v *GetNodeNodeIncomingEdgesEdgeSourceNode) GetMemoryId() string

GetMemoryId returns GetNodeNodeIncomingEdgesEdgeSourceNode.MemoryId, and is useful for accessing the field via an interface.

type GetNodeNodeOutgoingEdgesEdge added in v0.5.1 

type GetNodeNodeOutgoingEdgesEdge struct {
	Id string `json:"id"`
	// Free-form relationship name (e.g. imports, depends_on). Optional since
	// spec 037 — loc is the identity. (Was the required 'label'.)
	Name *string `json:"name"`
	// Colon-delimited path within the (source node's) memory — the edge's
	// identity and the suffix of its URN hrn:edge:<root>:<memory>:<loc>.
	Loc string `json:"loc"`
	// If true, this edge can be executed/run (task automation, conversation
	// transitions). Mirrors Node.isRunnable.
	IsRunnable *bool `json:"isRunnable"`
	// Resolution-order hook (lower = earlier; default 0). When two edges
	// share a priority, fall back to insertion order.
	Priority int `json:"priority"`
	// The target node. NULLABLE (#781): null when the caller cannot read the target node's memory (a cross-memory edge's far endpoint). For a same-memory edge, always present.
	Target *GetNodeNodeOutgoingEdgesEdgeTargetNode `json:"target"`
}

GetNodeNodeOutgoingEdgesEdge includes the requested fields of the GraphQL type Edge.

func (*GetNodeNodeOutgoingEdgesEdge) GetId added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdge) GetId() string

GetId returns GetNodeNodeOutgoingEdgesEdge.Id, and is useful for accessing the field via an interface.

func (*GetNodeNodeOutgoingEdgesEdge) GetIsRunnable added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdge) GetIsRunnable() *bool

GetIsRunnable returns GetNodeNodeOutgoingEdgesEdge.IsRunnable, and is useful for accessing the field via an interface.

func (*GetNodeNodeOutgoingEdgesEdge) GetLoc added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdge) GetLoc() string

GetLoc returns GetNodeNodeOutgoingEdgesEdge.Loc, and is useful for accessing the field via an interface.

func (*GetNodeNodeOutgoingEdgesEdge) GetName added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdge) GetName() *string

GetName returns GetNodeNodeOutgoingEdgesEdge.Name, and is useful for accessing the field via an interface.

func (*GetNodeNodeOutgoingEdgesEdge) GetPriority added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdge) GetPriority() int

GetPriority returns GetNodeNodeOutgoingEdgesEdge.Priority, and is useful for accessing the field via an interface.

func (*GetNodeNodeOutgoingEdgesEdge) GetTarget added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdge) GetTarget() *GetNodeNodeOutgoingEdgesEdgeTargetNode

GetTarget returns GetNodeNodeOutgoingEdgesEdge.Target, and is useful for accessing the field via an interface.

type GetNodeNodeOutgoingEdgesEdgeTargetNode added in v0.5.1 

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

GetNodeNodeOutgoingEdgesEdgeTargetNode includes the requested fields of the GraphQL type Node.

func (*GetNodeNodeOutgoingEdgesEdgeTargetNode) GetId added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdgeTargetNode) GetId() string

GetId returns GetNodeNodeOutgoingEdgesEdgeTargetNode.Id, and is useful for accessing the field via an interface.

func (*GetNodeNodeOutgoingEdgesEdgeTargetNode) GetLoc added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdgeTargetNode) GetLoc() string

GetLoc returns GetNodeNodeOutgoingEdgesEdgeTargetNode.Loc, and is useful for accessing the field via an interface.

func (*GetNodeNodeOutgoingEdgesEdgeTargetNode) GetMemoryId added in v0.5.1 

func (v *GetNodeNodeOutgoingEdgesEdgeTargetNode) GetMemoryId() string

GetMemoryId returns GetNodeNodeOutgoingEdgesEdgeTargetNode.MemoryId, and is useful for accessing the field via an interface.

type GetNodeRawResponse added in v0.18.0 

type GetNodeRawResponse struct {
	// The uniform single-node read (#473) — subsumes the former nodeById(id:)
	// and node(loc:, memory:) split. 'ref' accepts, in dispatch order:
	//
	// 1. a primary key (the unambiguous read — the old nodeById),
	// 2. a fully-qualified node URN (`hrn:node:<root>:<memory>:<loc>`,
	// legacy `urn:` scheme accepted),
	// 3. a bare loc — scoped by 'memoryRef' (an ID or URN) when given; unscoped,
	// it resolves across every readable memory and a cross-memory loc
	// collision is REJECTED with extensions.code AMBIGUOUS_NODE_LOC
	// (listing the candidate memoryIds) rather than silently returning
	// one (#335). An unprefixed 3+-segment ref whose first two segments
	// name a readable memory is treated as form 2 (a full URN); pass
	// 'memoryRef' to force loc interpretation.
	//
	// raw: true skips Mustache template compilation. Soft-deleted nodes do not
	// resolve. Access: the caller's readable-memory set (same gate the old
	// queries used); denied and missing are both null.
	Node *GetNodeNode `json:"node"`
}

GetNodeRawResponse is returned by GetNodeRaw on success.

func GetNodeRaw added in v0.18.0 

func GetNodeRaw(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetNodeRawResponse, err_ error)

The STORED content of one node, Mustache placeholders intact (#736).

The single-node `node` read COMPILES {{…}} templates against the node's data unless `raw: true` (hadron-server resolvers.query.node.ts), so a body read through GetNode and written back loses every placeholder — silently, since a read-back through the same rendered path agrees with what was written. The generic node paths that WRITE content they read (`coding preflight create|route`'s router splice) and `node get --raw` use this operation; the `spec` group has its own raw reads (GetSpecNodeRaw / GetSpecNodeForEdit, cli#737/#742/#738). `nodeBatch` and `nodeExport` never render, so their callers are already safe.

Same selection and the SAME Go type as GetNode (the typename directive): genqlient refuses to generate if the two selections ever diverge, so a field added to one and forgotten in the other is a build error, not a silent gap.

func (*GetNodeRawResponse) GetNode added in v0.18.0 

func (v *GetNodeRawResponse) GetNode() *GetNodeNode

GetNode returns GetNodeRawResponse.Node, and is useful for accessing the field via an interface.

type GetNodeResponse added in v0.5.1 

type GetNodeResponse struct {
	// The uniform single-node read (#473) — subsumes the former nodeById(id:)
	// and node(loc:, memory:) split. 'ref' accepts, in dispatch order:
	//
	// 1. a primary key (the unambiguous read — the old nodeById),
	// 2. a fully-qualified node URN (`hrn:node:<root>:<memory>:<loc>`,
	// legacy `urn:` scheme accepted),
	// 3. a bare loc — scoped by 'memoryRef' (an ID or URN) when given; unscoped,
	// it resolves across every readable memory and a cross-memory loc
	// collision is REJECTED with extensions.code AMBIGUOUS_NODE_LOC
	// (listing the candidate memoryIds) rather than silently returning
	// one (#335). An unprefixed 3+-segment ref whose first two segments
	// name a readable memory is treated as form 2 (a full URN); pass
	// 'memoryRef' to force loc interpretation.
	//
	// raw: true skips Mustache template compilation. Soft-deleted nodes do not
	// resolve. Access: the caller's readable-memory set (same gate the old
	// queries used); denied and missing are both null.
	Node *GetNodeNode `json:"node"`
}

GetNodeResponse is returned by GetNode on success.

func GetNode added in v0.5.1 

func GetNode(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetNodeResponse, err_ error)

The uniform single-node read (hadron-server#473) — node(ref:) subsumes the former nodeById(id:); ref accepts a PK, a fully-qualified node URN, or a bare loc (memory-scoped via the separate `memory` arg, unused here — the CLI resolves refs to PKs first via resolveUrn).

func (*GetNodeResponse) GetNode added in v0.5.1 

func (v *GetNodeResponse) GetNode() *GetNodeNode

GetNode returns GetNodeResponse.Node, and is useful for accessing the field via an interface.

type GetObjectResponse added in v0.8.0 

type GetObjectResponse struct {
	// #745 — read one object by its id (the object store's flat projection of a
	// node). Returns a JSON object { id, type, ...fields } or null if not
	// found/inaccessible. The object store is the legible sugar surface over
	// structured storage (an object IS a node); see createObject / findObjects.
	Object *json.RawMessage `json:"object"`
}

GetObjectResponse is returned by GetObject on success.

func GetObject added in v0.8.0 

func GetObject(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetObjectResponse, err_ error)

Read one object by id or node URN; the JSON is null when not found/inaccessible.

func (*GetObjectResponse) GetObject added in v0.8.0 

func (v *GetObjectResponse) GetObject() *json.RawMessage

GetObject returns GetObjectResponse.Object, and is useful for accessing the field via an interface.

type GetOrganizationOrganization added in v0.3.0 

type GetOrganizationOrganization struct {
	OrgFields `json:"-"`
}

GetOrganizationOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*GetOrganizationOrganization) GetCreatedAt added in v0.3.0 

func (v *GetOrganizationOrganization) GetCreatedAt() string

GetCreatedAt returns GetOrganizationOrganization.CreatedAt, and is useful for accessing the field via an interface.

func (*GetOrganizationOrganization) GetId added in v0.3.0 

func (v *GetOrganizationOrganization) GetId() string

GetId returns GetOrganizationOrganization.Id, and is useful for accessing the field via an interface.

func (*GetOrganizationOrganization) GetListedOnMarketplace added in v0.9.0 

func (v *GetOrganizationOrganization) GetListedOnMarketplace() bool

GetListedOnMarketplace returns GetOrganizationOrganization.ListedOnMarketplace, and is useful for accessing the field via an interface.

func (*GetOrganizationOrganization) GetName added in v0.3.0 

func (v *GetOrganizationOrganization) GetName() string

GetName returns GetOrganizationOrganization.Name, and is useful for accessing the field via an interface.

func (*GetOrganizationOrganization) GetUpdatedAt added in v0.3.0 

func (v *GetOrganizationOrganization) GetUpdatedAt() string

GetUpdatedAt returns GetOrganizationOrganization.UpdatedAt, and is useful for accessing the field via an interface.

func (*GetOrganizationOrganization) GetUrn added in v0.3.0 

func (v *GetOrganizationOrganization) GetUrn() string

GetUrn returns GetOrganizationOrganization.Urn, and is useful for accessing the field via an interface.

func (*GetOrganizationOrganization) MarshalJSON added in v0.3.0 

func (v *GetOrganizationOrganization) MarshalJSON() ([]byte, error)

func (*GetOrganizationOrganization) UnmarshalJSON added in v0.3.0 

func (v *GetOrganizationOrganization) UnmarshalJSON(b []byte) error

type GetOrganizationResponse added in v0.3.0 

type GetOrganizationResponse struct {
	// Fetch an Organization (org member or platform ADMIN).
	//
	// 'ref' accepts the entity's ID or URN.
	Organization *GetOrganizationOrganization `json:"organization"`
}

GetOrganizationResponse is returned by GetOrganization on success.

func GetOrganization added in v0.3.0 

func GetOrganization(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetOrganizationResponse, err_ error)

organization(ref:) accepts the org's PK id or URN (hadron-server#473).

func (*GetOrganizationResponse) GetOrganization added in v0.3.0 

func (v *GetOrganizationResponse) GetOrganization() *GetOrganizationOrganization

GetOrganization returns GetOrganizationResponse.Organization, and is useful for accessing the field via an interface.

type GetRegisterEntryRegisterEntry added in v0.15.0 

type GetRegisterEntryRegisterEntry struct {
	RegisterEntryFields `json:"-"`
}

GetRegisterEntryRegisterEntry includes the requested fields of the GraphQL type RegisterEntry. The GraphQL type's documentation follows.

A REGISTER ENTRY (spec 049, D-2026-09-13-007): "this attendee takes part in this Channel". The attendee is a Worker when cast, otherwise an Agent in an App; both null = every attendee in the owner's context (org-wide for an organization row, App-wide for an App row). Not a trigger list — a row never starts a run. The register never grants: what the attendee may read or post is the Channel's host memory's decision. Not exportable.

func (*GetRegisterEntryRegisterEntry) GetAttendeeUrn added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetAttendeeUrn() *string

GetAttendeeUrn returns GetRegisterEntryRegisterEntry.AttendeeUrn, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetChannelId added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetChannelId() string

GetChannelId returns GetRegisterEntryRegisterEntry.ChannelId, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetCreatedAt added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetCreatedAt() string

GetCreatedAt returns GetRegisterEntryRegisterEntry.CreatedAt, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetDescription added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetDescription() *string

GetDescription returns GetRegisterEntryRegisterEntry.Description, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetId added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetId() string

GetId returns GetRegisterEntryRegisterEntry.Id, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetInstallDefault added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetInstallDefault() bool

GetInstallDefault returns GetRegisterEntryRegisterEntry.InstallDefault, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetMentionOnly added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetMentionOnly() bool

GetMentionOnly returns GetRegisterEntryRegisterEntry.MentionOnly, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetOrganizationId added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetOrganizationId() *string

GetOrganizationId returns GetRegisterEntryRegisterEntry.OrganizationId, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetOwnerId added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetOwnerId() string

GetOwnerId returns GetRegisterEntryRegisterEntry.OwnerId, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetOwnerType added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetOwnerType() RegisterOwnerType

GetOwnerType returns GetRegisterEntryRegisterEntry.OwnerType, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetRole added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetRole() RegisterRole

GetRole returns GetRegisterEntryRegisterEntry.Role, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) GetUpdatedAt added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) GetUpdatedAt() *string

GetUpdatedAt returns GetRegisterEntryRegisterEntry.UpdatedAt, and is useful for accessing the field via an interface.

func (*GetRegisterEntryRegisterEntry) MarshalJSON added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) MarshalJSON() ([]byte, error)

func (*GetRegisterEntryRegisterEntry) UnmarshalJSON added in v0.15.0 

func (v *GetRegisterEntryRegisterEntry) UnmarshalJSON(b []byte) error

type GetRegisterEntryResponse added in v0.15.0 

type GetRegisterEntryResponse struct {
	// Spec 049 Phase 5 — one register entry. Null when missing OR when you may
	// neither read its Channel's host memory nor stand on the row's owner side.
	RegisterEntry *GetRegisterEntryRegisterEntry `json:"registerEntry"`
}

GetRegisterEntryResponse is returned by GetRegisterEntry on success.

func GetRegisterEntry added in v0.15.0 

func GetRegisterEntry(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetRegisterEntryResponse, err_ error)

func (*GetRegisterEntryResponse) GetRegisterEntry added in v0.15.0 

func (v *GetRegisterEntryResponse) GetRegisterEntry() *GetRegisterEntryRegisterEntry

GetRegisterEntry returns GetRegisterEntryResponse.RegisterEntry, and is useful for accessing the field via an interface.

type GetScopeResponse added in v0.14.0 

type GetScopeResponse struct {
	// Spec 049 Phase 2 — the uniform single-scope read (cor:api:120). 'ref' is
	// the scope's ID (a Scope has no URN yet). Null when missing OR when you may
	// not read it — no existence disclosure. Read gate: an org scope to that
	// org's members, an App scope to the App's participants, an Agent scope to
	// whoever may read the Agent.
	Scope *GetScopeScope `json:"scope"`
}

GetScopeResponse is returned by GetScope on success.

func GetScope added in v0.14.0 

func GetScope(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetScopeResponse, err_ error)

Single-scope read BY ID — a Scope has no URN yet.

Returns null when the scope does not exist AND when the caller may not read it, identically and on purpose ("no existence disclosure"). Callers must render ONE message covering both and must not infer not-found from the null; see findings:a-deliberate-server-ambiguity-is-not-a-gap-to-close.

func (*GetScopeResponse) GetScope added in v0.14.0 

func (v *GetScopeResponse) GetScope() *GetScopeScope

GetScope returns GetScopeResponse.Scope, and is useful for accessing the field via an interface.

type GetScopeScope added in v0.14.0 

type GetScopeScope struct {
	ScopeFields   `json:"-"`
	ScopeMemories `json:"-"`
}

GetScopeScope includes the requested fields of the GraphQL type Scope. The GraphQL type's documentation follows.

A named search SCOPE: an ORDERED list of memories with exactly one owner (organization | Agent | App). Selects memories only — no saved filter, no retrieval parameters — and NEVER grants: `memories` is the stored list ∩ what YOU may read (D-2026-09-13-004), and `hiddenMemoryCount` says how many you cannot see, as a count only. Names are unique per owner; `global` and `app` are reserved (the ladder's own views). Collisions across owners in an App's context resolve App › Agent › organization, never unioned.

func (*GetScopeScope) GetCreatedAt added in v0.14.0 

func (v *GetScopeScope) GetCreatedAt() string

GetCreatedAt returns GetScopeScope.CreatedAt, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetDescription added in v0.14.0 

func (v *GetScopeScope) GetDescription() *string

GetDescription returns GetScopeScope.Description, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetHiddenMemoryCount added in v0.14.0 

func (v *GetScopeScope) GetHiddenMemoryCount() int

GetHiddenMemoryCount returns GetScopeScope.HiddenMemoryCount, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetId added in v0.14.0 

func (v *GetScopeScope) GetId() string

GetId returns GetScopeScope.Id, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetMemories added in v0.14.0 

func (v *GetScopeScope) GetMemories() []*ScopeMemoriesMemoriesScopeMemoryEntry

GetMemories returns GetScopeScope.Memories, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetMemoryCount added in v0.14.0 

func (v *GetScopeScope) GetMemoryCount() int

GetMemoryCount returns GetScopeScope.MemoryCount, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetName added in v0.14.0 

func (v *GetScopeScope) GetName() string

GetName returns GetScopeScope.Name, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetOwnerId added in v0.14.0 

func (v *GetScopeScope) GetOwnerId() string

GetOwnerId returns GetScopeScope.OwnerId, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetOwnerType added in v0.14.0 

func (v *GetScopeScope) GetOwnerType() ScopeOwnerType

GetOwnerType returns GetScopeScope.OwnerType, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetOwnerUrn added in v0.14.0 

func (v *GetScopeScope) GetOwnerUrn() *string

GetOwnerUrn returns GetScopeScope.OwnerUrn, and is useful for accessing the field via an interface.

func (*GetScopeScope) GetUpdatedAt added in v0.14.0 

func (v *GetScopeScope) GetUpdatedAt() *string

GetUpdatedAt returns GetScopeScope.UpdatedAt, and is useful for accessing the field via an interface.

func (*GetScopeScope) MarshalJSON added in v0.14.0 

func (v *GetScopeScope) MarshalJSON() ([]byte, error)

func (*GetScopeScope) UnmarshalJSON added in v0.14.0 

func (v *GetScopeScope) UnmarshalJSON(b []byte) error

type GetSpecNodeForEditNode added in v0.18.0 

type GetSpecNodeForEditNode struct {
	Id          string   `json:"id"`
	MemoryId    string   `json:"memoryId"`
	Loc         string   `json:"loc"`
	Name        string   `json:"name"`
	Description *string  `json:"description"`
	Tags        []string `json:"tags"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role    *string `json:"role"`
	Content *string `json:"content"`
	// Paragraph-length summary of this node. Opt-in on hadron_get_node via the contentScope parameter. hadron_find_nodes preview surfacing ships in spec 031 US2 — not yet live. Never surfaced in hadron_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: the abstract may not reflect current content when the two differ, OR when this is NULL on a node that has both an abstract and content (#1128 — an abstract written before the body existed was never fingerprinted, so it has never been checked against it; that reads as unverified, not as verified). NULL is only a clean state when the node has no abstract, or no content for the abstract to describe. Note restoreNodeRevision restores this field verbatim, so restoring a snapshot taken while it was NULL reinstates the unverified state — correctly, since that abstract has never been checked against the restored content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string `json:"abstractOriginHash"`
	// #1323 — current live revision. Creation is revision 1; each committed authoring change advances it. NodeRevision.revNo N is the retained snapshot of this node when revision N was current, before the edit that advanced it.
	Revision int `json:"revision"`
}

GetSpecNodeForEditNode includes the requested fields of the GraphQL type Node.

func (*GetSpecNodeForEditNode) GetAbstract added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetAbstract() *string

GetAbstract returns GetSpecNodeForEditNode.Abstract, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetAbstractOriginHash added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetAbstractOriginHash() *string

GetAbstractOriginHash returns GetSpecNodeForEditNode.AbstractOriginHash, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetContent added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetContent() *string

GetContent returns GetSpecNodeForEditNode.Content, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetDescription added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetDescription() *string

GetDescription returns GetSpecNodeForEditNode.Description, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetId added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetId() string

GetId returns GetSpecNodeForEditNode.Id, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetLoc added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetLoc() string

GetLoc returns GetSpecNodeForEditNode.Loc, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetMemoryId added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetMemoryId() string

GetMemoryId returns GetSpecNodeForEditNode.MemoryId, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetName added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetName() string

GetName returns GetSpecNodeForEditNode.Name, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetRevision added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetRevision() int

GetRevision returns GetSpecNodeForEditNode.Revision, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetRole added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetRole() *string

GetRole returns GetSpecNodeForEditNode.Role, and is useful for accessing the field via an interface.

func (*GetSpecNodeForEditNode) GetTags added in v0.18.0 

func (v *GetSpecNodeForEditNode) GetTags() []string

GetTags returns GetSpecNodeForEditNode.Tags, and is useful for accessing the field via an interface.

type GetSpecNodeForEditResponse added in v0.18.0 

type GetSpecNodeForEditResponse struct {
	// The uniform single-node read (#473) — subsumes the former nodeById(id:)
	// and node(loc:, memory:) split. 'ref' accepts, in dispatch order:
	//
	// 1. a primary key (the unambiguous read — the old nodeById),
	// 2. a fully-qualified node URN (`hrn:node:<root>:<memory>:<loc>`,
	// legacy `urn:` scheme accepted),
	// 3. a bare loc — scoped by 'memoryRef' (an ID or URN) when given; unscoped,
	// it resolves across every readable memory and a cross-memory loc
	// collision is REJECTED with extensions.code AMBIGUOUS_NODE_LOC
	// (listing the candidate memoryIds) rather than silently returning
	// one (#335). An unprefixed 3+-segment ref whose first two segments
	// name a readable memory is treated as form 2 (a full URN); pass
	// 'memoryRef' to force loc interpretation.
	//
	// raw: true skips Mustache template compilation. Soft-deleted nodes do not
	// resolve. Access: the caller's readable-memory set (same gate the old
	// queries used); denied and missing are both null.
	Node *GetSpecNodeForEditNode `json:"node"`
}

GetSpecNodeForEditResponse is returned by GetSpecNodeForEdit on success.

func GetSpecNodeForEdit added in v0.18.0 

func GetSpecNodeForEdit(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetSpecNodeForEditResponse, err_ error)

`spec edit`'s read (cli#738): GetSpecNodeRaw's stored body PLUS the node's live revision, from ONE read. The guarded save sends that revision as `expectedRevision` (hadron-server#1352), so the server refuses the write if the spec changed since this read, instead of overwriting the change.

Its own operation rather than a field on GetSpecNodeRaw: `supersede` and `extract` share that read (cli#742) and do not need a revision, and on a server predating `Node.revision` (hadron-server#1339) the field would fail their whole query. Only `spec edit` requires it — and refuses clearly without it, since an unguarded save is exactly what cli#738 removes.

func (*GetSpecNodeForEditResponse) GetNode added in v0.18.0 

func (v *GetSpecNodeForEditResponse) GetNode() *GetSpecNodeForEditNode

GetNode returns GetSpecNodeForEditResponse.Node, and is useful for accessing the field via an interface.

type GetSpecNodeRawNode added in v0.18.0 

type GetSpecNodeRawNode struct {
	Id       string   `json:"id"`
	MemoryId string   `json:"memoryId"`
	Loc      string   `json:"loc"`
	Name     string   `json:"name"`
	Tags     []string `json:"tags"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role    *string `json:"role"`
	Content *string `json:"content"`
	// Paragraph-length summary of this node. Opt-in on hadron_get_node via the contentScope parameter. hadron_find_nodes preview surfacing ships in spec 031 US2 — not yet live. Never surfaced in hadron_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: the abstract may not reflect current content when the two differ, OR when this is NULL on a node that has both an abstract and content (#1128 — an abstract written before the body existed was never fingerprinted, so it has never been checked against it; that reads as unverified, not as verified). NULL is only a clean state when the node has no abstract, or no content for the abstract to describe. Note restoreNodeRevision restores this field verbatim, so restoring a snapshot taken while it was NULL reinstates the unverified state — correctly, since that abstract has never been checked against the restored content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string `json:"abstractOriginHash"`
}

GetSpecNodeRawNode includes the requested fields of the GraphQL type Node.

func (*GetSpecNodeRawNode) GetAbstract added in v0.18.0 

func (v *GetSpecNodeRawNode) GetAbstract() *string

GetAbstract returns GetSpecNodeRawNode.Abstract, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetAbstractOriginHash added in v0.18.0 

func (v *GetSpecNodeRawNode) GetAbstractOriginHash() *string

GetAbstractOriginHash returns GetSpecNodeRawNode.AbstractOriginHash, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetContent added in v0.18.0 

func (v *GetSpecNodeRawNode) GetContent() *string

GetContent returns GetSpecNodeRawNode.Content, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetId added in v0.18.0 

func (v *GetSpecNodeRawNode) GetId() string

GetId returns GetSpecNodeRawNode.Id, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetLoc added in v0.18.0 

func (v *GetSpecNodeRawNode) GetLoc() string

GetLoc returns GetSpecNodeRawNode.Loc, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetMemoryId added in v0.18.0 

func (v *GetSpecNodeRawNode) GetMemoryId() string

GetMemoryId returns GetSpecNodeRawNode.MemoryId, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetName added in v0.18.0 

func (v *GetSpecNodeRawNode) GetName() string

GetName returns GetSpecNodeRawNode.Name, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetRole added in v0.18.0 

func (v *GetSpecNodeRawNode) GetRole() *string

GetRole returns GetSpecNodeRawNode.Role, and is useful for accessing the field via an interface.

func (*GetSpecNodeRawNode) GetTags added in v0.18.0 

func (v *GetSpecNodeRawNode) GetTags() []string

GetTags returns GetSpecNodeRawNode.Tags, and is useful for accessing the field via an interface.

type GetSpecNodeRawResponse added in v0.18.0 

type GetSpecNodeRawResponse struct {
	// The uniform single-node read (#473) — subsumes the former nodeById(id:)
	// and node(loc:, memory:) split. 'ref' accepts, in dispatch order:
	//
	// 1. a primary key (the unambiguous read — the old nodeById),
	// 2. a fully-qualified node URN (`hrn:node:<root>:<memory>:<loc>`,
	// legacy `urn:` scheme accepted),
	// 3. a bare loc — scoped by 'memoryRef' (an ID or URN) when given; unscoped,
	// it resolves across every readable memory and a cross-memory loc
	// collision is REJECTED with extensions.code AMBIGUOUS_NODE_LOC
	// (listing the candidate memoryIds) rather than silently returning
	// one (#335). An unprefixed 3+-segment ref whose first two segments
	// name a readable memory is treated as form 2 (a full URN); pass
	// 'memoryRef' to force loc interpretation.
	//
	// raw: true skips Mustache template compilation. Soft-deleted nodes do not
	// resolve. Access: the caller's readable-memory set (same gate the old
	// queries used); denied and missing are both null.
	Node *GetSpecNodeRawNode `json:"node"`
}

GetSpecNodeRawResponse is returned by GetSpecNodeRaw on success.

func GetSpecNodeRaw added in v0.18.0 

func GetSpecNodeRaw(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetSpecNodeRawResponse, err_ error)

`spec edit`'s read (cli#737). A dedicated operation rather than GetNode, for one reason: `raw: true`.

Without it node(ref:) compiles the body's Mustache before returning it, so a `{{name}}` placeholder comes back RENDERED (measured on production, cli#737: spec cor:agt:040:01 has 4 `{{` occurrences read raw and 0 read plain, at the same revision). `spec edit` builds everything from this read (the $EDITOR buffer, the dry-run preview and the write), and from rendered text it would preview a diff of text that is not stored and, on an interactive save, write the placeholders away.

`raw` has been on the server since hadron-server 7b5f66d6 (2026-04-12). It is a literal, not a variable, so no caller can forget it. Only the fields the edit path uses are selected; the general single-node read stays GetNode (whether its callers go raw is cli#736).

func (*GetSpecNodeRawResponse) GetNode added in v0.18.0 

func (v *GetSpecNodeRawResponse) GetNode() *GetSpecNodeRawNode

GetNode returns GetSpecNodeRawResponse.Node, and is useful for accessing the field via an interface.

type GetTeamSessionResponse added in v0.9.0 

type GetTeamSessionResponse struct {
	Session *GetTeamSessionSession `json:"session"`
}

GetTeamSessionResponse is returned by GetTeamSession on success.

func GetTeamSession added in v0.9.0 

func GetTeamSession(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *GetTeamSessionResponse, err_ error)

One session by id — the provenance query resolves worklog sessionIds through this (sessions have no URN; id-only is the cor:api:140 genuine-PK case). Null when not found or not visible.

func (*GetTeamSessionResponse) GetSession added in v0.9.0 

func (v *GetTeamSessionResponse) GetSession() *GetTeamSessionSession

GetSession returns GetTeamSessionResponse.Session, and is useful for accessing the field via an interface.

type GetTeamSessionSession added in v0.9.0 

type GetTeamSessionSession struct {
	TeamSessionFields `json:"-"`
}

GetTeamSessionSession includes the requested fields of the GraphQL type Session. The GraphQL type's documentation follows.

A unit of work recorded against a user or App: the general row, and what the bare word "session" means throughout this schema (#1034). `type` says which kind — DEVELOPER, CHATBOT, AUTOMATION, EDGE — and `workerId` is optional.

A **worker session** is the subtype with `workerId` set: a Worker (named casting) bound to a driver, which is what makes work attributable to a teammate and what a merged PR traces back through. Binding is optional, so a list of these is not a staff view and may hold no worker sessions at all — read `workerId` per row rather than assuming either way.

A **chat session** is NOT one of these and has no row here: it is the conversation a human is in — the Claude Desktop window, the Claude Code session, the IDE chat. The two are independent and **ending one does not end the other**: a chat session that closes leaves its worker session open until endSession. Since #1114 nothing ends it for inactivity — silence is not evidence of abandonment — but it stops reading as LIVE once nobody has driven it inside its idle window, so the stale session stops blocking another bind without being ended or losing its unwritten handoff. That changes no HOLD: a human-held name stays held until explicit release, so only its holder can bind it again. Do not use "chat session" for a Chat (the agent conversation entity) — that is an **agent chat**, a third concept.

func (*GetTeamSessionSession) GetAgentId added in v0.9.0 

func (v *GetTeamSessionSession) GetAgentId() *string

GetAgentId returns GetTeamSessionSession.AgentId, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetAutoExpiredAt added in v0.15.0 

func (v *GetTeamSessionSession) GetAutoExpiredAt() *string

GetAutoExpiredAt returns GetTeamSessionSession.AutoExpiredAt, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetBranch added in v0.9.0 

func (v *GetTeamSessionSession) GetBranch() *string

GetBranch returns GetTeamSessionSession.Branch, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetEndedAt added in v0.9.0 

func (v *GetTeamSessionSession) GetEndedAt() *string

GetEndedAt returns GetTeamSessionSession.EndedAt, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetHost added in v0.9.0 

func (v *GetTeamSessionSession) GetHost() *string

GetHost returns GetTeamSessionSession.Host, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetId added in v0.9.0 

func (v *GetTeamSessionSession) GetId() string

GetId returns GetTeamSessionSession.Id, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetLlmModel added in v0.9.0 

func (v *GetTeamSessionSession) GetLlmModel() *string

GetLlmModel returns GetTeamSessionSession.LlmModel, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetPrNumber added in v0.9.0 

func (v *GetTeamSessionSession) GetPrNumber() *int

GetPrNumber returns GetTeamSessionSession.PrNumber, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetRepo added in v0.9.0 

func (v *GetTeamSessionSession) GetRepo() *string

GetRepo returns GetTeamSessionSession.Repo, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetStartedAt added in v0.9.0 

func (v *GetTeamSessionSession) GetStartedAt() string

GetStartedAt returns GetTeamSessionSession.StartedAt, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetTool added in v0.9.0 

func (v *GetTeamSessionSession) GetTool() *string

GetTool returns GetTeamSessionSession.Tool, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetTranscriptPath added in v0.9.0 

func (v *GetTeamSessionSession) GetTranscriptPath() *string

GetTranscriptPath returns GetTeamSessionSession.TranscriptPath, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetType added in v0.9.0 

func (v *GetTeamSessionSession) GetType() string

GetType returns GetTeamSessionSession.Type, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetUserId added in v0.9.0 

func (v *GetTeamSessionSession) GetUserId() *string

GetUserId returns GetTeamSessionSession.UserId, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetWorker added in v0.9.0 

func (v *GetTeamSessionSession) GetWorker() *TeamSessionFieldsWorker

GetWorker returns GetTeamSessionSession.Worker, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) GetWorkerId added in v0.9.0 

func (v *GetTeamSessionSession) GetWorkerId() *string

GetWorkerId returns GetTeamSessionSession.WorkerId, and is useful for accessing the field via an interface.

func (*GetTeamSessionSession) MarshalJSON added in v0.9.0 

func (v *GetTeamSessionSession) MarshalJSON() ([]byte, error)

func (*GetTeamSessionSession) UnmarshalJSON added in v0.9.0 

func (v *GetTeamSessionSession) UnmarshalJSON(b []byte) error

type GetUserResponse added in v0.5.1 

type GetUserResponse struct {
	// The uniform single-user read (#473). 'ref' accepts a primary key or a
	// `hrn:user:<handle>` URN. Resolves for the user themselves, a platform
	// ADMIN/OWNER, or a caller sharing at least one organization with the
	// target (the resolveUrn user gate); anyone else gets null — denied and
	// missing are indistinguishable, preserving #384's anti-enumeration
	// posture. PII fields (name/email) stay gated by the User field resolvers.
	User *GetUserUser `json:"user"`
}

GetUserResponse is returned by GetUser on success.

func GetUser added in v0.5.1 

func GetUser(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetUserResponse, err_ error)

The uniform single-user read (hadron-server#473): ref accepts a PK or an hrn:user:<handle> URN; denied and missing are both null (anti-enumeration). The access-check user resolution tries this before falling back to the paged search below.

func (*GetUserResponse) GetUser added in v0.5.1 

func (v *GetUserResponse) GetUser() *GetUserUser

GetUser returns GetUserResponse.User, and is useful for accessing the field via an interface.

type GetUserUser added in v0.5.1 

type GetUserUser struct {
	UserFields `json:"-"`
}

GetUserUser includes the requested fields of the GraphQL type User.

func (*GetUserUser) GetEmail added in v0.5.1 

func (v *GetUserUser) GetEmail() *string

GetEmail returns GetUserUser.Email, and is useful for accessing the field via an interface.

func (*GetUserUser) GetExternalAppId added in v0.9.0 

func (v *GetUserUser) GetExternalAppId() *string

GetExternalAppId returns GetUserUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*GetUserUser) GetExternalId added in v0.9.0 

func (v *GetUserUser) GetExternalId() *string

GetExternalId returns GetUserUser.ExternalId, and is useful for accessing the field via an interface.

func (*GetUserUser) GetGithubId added in v0.9.0 

func (v *GetUserUser) GetGithubId() *int

GetGithubId returns GetUserUser.GithubId, and is useful for accessing the field via an interface.

func (*GetUserUser) GetGithubUsername added in v0.5.1 

func (v *GetUserUser) GetGithubUsername() *string

GetGithubUsername returns GetUserUser.GithubUsername, and is useful for accessing the field via an interface.

func (*GetUserUser) GetHandle added in v0.5.1 

func (v *GetUserUser) GetHandle() *string

GetHandle returns GetUserUser.Handle, and is useful for accessing the field via an interface.

func (*GetUserUser) GetId added in v0.5.1 

func (v *GetUserUser) GetId() string

GetId returns GetUserUser.Id, and is useful for accessing the field via an interface.

func (*GetUserUser) GetIdentityProvider added in v0.9.0 

func (v *GetUserUser) GetIdentityProvider() *string

GetIdentityProvider returns GetUserUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*GetUserUser) GetLinkedAt added in v0.9.0 

func (v *GetUserUser) GetLinkedAt() *string

GetLinkedAt returns GetUserUser.LinkedAt, and is useful for accessing the field via an interface.

func (*GetUserUser) GetName added in v0.5.1 

func (v *GetUserUser) GetName() *string

GetName returns GetUserUser.Name, and is useful for accessing the field via an interface.

func (*GetUserUser) GetRoles added in v0.5.1 

func (v *GetUserUser) GetRoles() []Role

GetRoles returns GetUserUser.Roles, and is useful for accessing the field via an interface.

func (*GetUserUser) GetUrn added in v0.14.0 

func (v *GetUserUser) GetUrn() *string

GetUrn returns GetUserUser.Urn, and is useful for accessing the field via an interface.

func (*GetUserUser) MarshalJSON added in v0.5.1 

func (v *GetUserUser) MarshalJSON() ([]byte, error)

func (*GetUserUser) UnmarshalJSON added in v0.5.1 

func (v *GetUserUser) UnmarshalJSON(b []byte) error

type GetWorkerContinuityResponse added in v0.18.0 

type GetWorkerContinuityResponse struct {
	// One Worker by ref (#974) — its id, its URN (#991), or (with appRef) its
	// NAME (#1015), the ergonomic handle a human already knows. The name form is
	// ADDITIVE: it is activated by appRef, since a name is unique only within an
	// App. Without appRef the ref must be an id or URN, and anything else refuses
	// WORKER_NOT_FOUND as before. An id or URN wins over appRef rather than being
	// checked against it, so a typo'd URN never degrades into a roster search.
	//
	// Selecting `prompt` re-renders the worker's boot briefing live from the
	// role agent's template — the read that lets an agent recover a briefing it
	// lost to a context compaction, instead of opening a second session or
	// forcing a takeover of itself.
	//
	// Authorization: an AppMember of the worker's App (any role), an org member
	// with CONTRIBUTOR+ on its org, the owner of a user-owned App, or the App's
	// own key. For the NAME form the gate runs BEFORE the lookup and a denial is
	// reported as WORKER_NOT_FOUND, so the roster is not an existence oracle.
	Worker *GetWorkerContinuityWorker `json:"worker"`
}

GetWorkerContinuityResponse is returned by GetWorkerContinuity on success.

func GetWorkerContinuity added in v0.18.0 

func GetWorkerContinuity(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetWorkerContinuityResponse, err_ error)

#790 / server#1029: the handoff is deliberately a separate operation from GetWorker and Workers. Older servers do not know Worker.continuity and reject a document that selects it before execution, even if a caller ignores the response field. The ordinary worker lookup must still bind on those servers.

func (*GetWorkerContinuityResponse) GetWorker added in v0.18.0 

func (v *GetWorkerContinuityResponse) GetWorker() *GetWorkerContinuityWorker

GetWorker returns GetWorkerContinuityResponse.Worker, and is useful for accessing the field via an interface.

type GetWorkerContinuityWorker added in v0.18.0 

type GetWorkerContinuityWorker struct {
	// #1029 — what a fresh binding of this worker inherits from the last one.
	//
	// Returned by startSession alongside the boot briefing (binding is briefing,
	// so binding is handoff) and by the worker read, which is the recovery path
	// after a context compaction — the reader who has most lost the handoff and
	// least knows one exists. Working-state field: behind the worker read gate,
	// masked to null on deny, like prompt/promptOverride/memoryId.
	Continuity *GetWorkerContinuityWorkerContinuity `json:"continuity"`
}

GetWorkerContinuityWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*GetWorkerContinuityWorker) GetContinuity added in v0.18.0 

func (v *GetWorkerContinuityWorker) GetContinuity() *GetWorkerContinuityWorkerContinuity

GetContinuity returns GetWorkerContinuityWorker.Continuity, and is useful for accessing the field via an interface.

type GetWorkerContinuityWorkerContinuity added in v0.18.0 

type GetWorkerContinuityWorkerContinuity struct {
	Status WorkerContinuityStatus `json:"status"`
	// The newest handoff node, or null when the worker has none. Present even
	// when status is MISSING — a stale handoff is still the best available
	// account of where this worker got to, and withholding it helps nobody.
	Handoff *GetWorkerContinuityWorkerContinuityHandoffNode `json:"handoff"`
	// The worker's most recent ENDED session, as a SANITIZED projection — the
	// three facts continuity needs, and deliberately not the Session object.
	//
	// The worker read gate that admits this field is WIDER than the session read
	// gate: an AppMember who is not an org member passes the first and fails the
	// second. Returning a Session here would hand them another driver's
	// transcriptPath, host, repo and summary through its field resolvers, which
	// assume the outer query authorized them (#552 / #983).
	PreviousSession *GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession `json:"previousSession"`
}

GetWorkerContinuityWorkerContinuity includes the requested fields of the GraphQL type WorkerContinuity. The GraphQL type's documentation follows.

#1029 — the continuity a worker carries between stints.

Handoffs are ordinary nodes in the worker's working memory, so a client walks the whole sequence through the node surface. This type exists for the ONE handoff that cannot be discovered: the newest, which a fresh session does not know to look for.

func (*GetWorkerContinuityWorkerContinuity) GetHandoff added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuity) GetHandoff() *GetWorkerContinuityWorkerContinuityHandoffNode

GetHandoff returns GetWorkerContinuityWorkerContinuity.Handoff, and is useful for accessing the field via an interface.

func (*GetWorkerContinuityWorkerContinuity) GetPreviousSession added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuity) GetPreviousSession() *GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession

GetPreviousSession returns GetWorkerContinuityWorkerContinuity.PreviousSession, and is useful for accessing the field via an interface.

func (*GetWorkerContinuityWorkerContinuity) GetStatus added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuity) GetStatus() WorkerContinuityStatus

GetStatus returns GetWorkerContinuityWorkerContinuity.Status, and is useful for accessing the field via an interface.

type GetWorkerContinuityWorkerContinuityHandoffNode added in v0.18.0 

type GetWorkerContinuityWorkerContinuityHandoffNode struct {
	// Fully-qualified node URN (hrn:node:<root>:<memory>:<loc>), composed server-side from the node's memory URN + loc (#481). Carried by every Node-returning surface (findNodes, node, appNodes, nodeBatch, mutation returns).
	Urn       string  `json:"urn"`
	Loc       string  `json:"loc"`
	Content   *string `json:"content"`
	CreatedAt string  `json:"createdAt"`
}

GetWorkerContinuityWorkerContinuityHandoffNode includes the requested fields of the GraphQL type Node.

func (*GetWorkerContinuityWorkerContinuityHandoffNode) GetContent added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuityHandoffNode) GetContent() *string

GetContent returns GetWorkerContinuityWorkerContinuityHandoffNode.Content, and is useful for accessing the field via an interface.

func (*GetWorkerContinuityWorkerContinuityHandoffNode) GetCreatedAt added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuityHandoffNode) GetCreatedAt() string

GetCreatedAt returns GetWorkerContinuityWorkerContinuityHandoffNode.CreatedAt, and is useful for accessing the field via an interface.

func (*GetWorkerContinuityWorkerContinuityHandoffNode) GetLoc added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuityHandoffNode) GetLoc() string

GetLoc returns GetWorkerContinuityWorkerContinuityHandoffNode.Loc, and is useful for accessing the field via an interface.

func (*GetWorkerContinuityWorkerContinuityHandoffNode) GetUrn added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuityHandoffNode) GetUrn() string

GetUrn returns GetWorkerContinuityWorkerContinuityHandoffNode.Urn, and is useful for accessing the field via an interface.

type GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession added in v0.18.0 

type GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession struct {
	Id      string  `json:"id"`
	EndedAt *string `json:"endedAt"`
	// Set when the #930 reaper ended it — nobody closed this stint deliberately.
	AutoExpiredAt *string `json:"autoExpiredAt"`
}

GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession includes the requested fields of the GraphQL type WorkerContinuitySession. The GraphQL type's documentation follows.

#1029 — the previous stint, reduced to what a successor needs to know: which session it was, when it ended, and whether the server reaped it. Not a Session, on purpose (see WorkerContinuity.previousSession).

func (*GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession) GetAutoExpiredAt added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession) GetAutoExpiredAt() *string

GetAutoExpiredAt returns GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession.AutoExpiredAt, and is useful for accessing the field via an interface.

func (*GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession) GetEndedAt added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession) GetEndedAt() *string

GetEndedAt returns GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession.EndedAt, and is useful for accessing the field via an interface.

func (*GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession) GetId added in v0.18.0 

func (v *GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession) GetId() string

GetId returns GetWorkerContinuityWorkerContinuityPreviousSessionWorkerContinuitySession.Id, and is useful for accessing the field via an interface.

type GetWorkerResponse added in v0.9.0 

type GetWorkerResponse struct {
	// One Worker by ref (#974) — its id, its URN (#991), or (with appRef) its
	// NAME (#1015), the ergonomic handle a human already knows. The name form is
	// ADDITIVE: it is activated by appRef, since a name is unique only within an
	// App. Without appRef the ref must be an id or URN, and anything else refuses
	// WORKER_NOT_FOUND as before. An id or URN wins over appRef rather than being
	// checked against it, so a typo'd URN never degrades into a roster search.
	//
	// Selecting `prompt` re-renders the worker's boot briefing live from the
	// role agent's template — the read that lets an agent recover a briefing it
	// lost to a context compaction, instead of opening a second session or
	// forcing a takeover of itself.
	//
	// Authorization: an AppMember of the worker's App (any role), an org member
	// with CONTRIBUTOR+ on its org, the owner of a user-owned App, or the App's
	// own key. For the NAME form the gate runs BEFORE the lookup and a denial is
	// reported as WORKER_NOT_FOUND, so the roster is not an existence oracle.
	Worker *GetWorkerWorker `json:"worker"`
}

GetWorkerResponse is returned by GetWorker on success.

func GetWorker added in v0.9.0 

func GetWorker(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *GetWorkerResponse, err_ error)

One worker by ref — its id, or its URN (#991); both resolve here, which is what lets a caller address a worker without holding its id.

func (*GetWorkerResponse) GetWorker added in v0.9.0 

func (v *GetWorkerResponse) GetWorker() *GetWorkerWorker

GetWorker returns GetWorkerResponse.Worker, and is useful for accessing the field via an interface.

type GetWorkerWorker added in v0.9.0 

type GetWorkerWorker struct {
	WorkerFields `json:"-"`
}

GetWorkerWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*GetWorkerWorker) GetAgentId added in v0.9.0 

func (v *GetWorkerWorker) GetAgentId() string

GetAgentId returns GetWorkerWorker.AgentId, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetAppId added in v0.9.0 

func (v *GetWorkerWorker) GetAppId() string

GetAppId returns GetWorkerWorker.AppId, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetCreatedAt added in v0.9.0 

func (v *GetWorkerWorker) GetCreatedAt() string

GetCreatedAt returns GetWorkerWorker.CreatedAt, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetCreatedBy added in v0.9.0 

func (v *GetWorkerWorker) GetCreatedBy() *string

GetCreatedBy returns GetWorkerWorker.CreatedBy, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetHasLiveSession added in v0.13.0 

func (v *GetWorkerWorker) GetHasLiveSession() *bool

GetHasLiveSession returns GetWorkerWorker.HasLiveSession, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetHeldAt added in v0.10.0 

func (v *GetWorkerWorker) GetHeldAt() *string

GetHeldAt returns GetWorkerWorker.HeldAt, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetHeldByUserId added in v0.10.0 

func (v *GetWorkerWorker) GetHeldByUserId() *string

GetHeldByUserId returns GetWorkerWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetId added in v0.9.0 

func (v *GetWorkerWorker) GetId() string

GetId returns GetWorkerWorker.Id, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetLastActiveAt added in v0.13.0 

func (v *GetWorkerWorker) GetLastActiveAt() *string

GetLastActiveAt returns GetWorkerWorker.LastActiveAt, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetMemoryId added in v0.9.0 

func (v *GetWorkerWorker) GetMemoryId() *string

GetMemoryId returns GetWorkerWorker.MemoryId, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetName added in v0.9.0 

func (v *GetWorkerWorker) GetName() string

GetName returns GetWorkerWorker.Name, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetPortalUrl added in v0.12.0 

func (v *GetWorkerWorker) GetPortalUrl() *string

GetPortalUrl returns GetWorkerWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetPrompt added in v0.9.0 

func (v *GetWorkerWorker) GetPrompt() *string

GetPrompt returns GetWorkerWorker.Prompt, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetPromptOverride added in v0.9.0 

func (v *GetWorkerWorker) GetPromptOverride() *string

GetPromptOverride returns GetWorkerWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetRepos added in v0.12.0 

func (v *GetWorkerWorker) GetRepos() []string

GetRepos returns GetWorkerWorker.Repos, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetRetiredAt added in v0.9.0 

func (v *GetWorkerWorker) GetRetiredAt() *string

GetRetiredAt returns GetWorkerWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetRetiredBy added in v0.9.0 

func (v *GetWorkerWorker) GetRetiredBy() *string

GetRetiredBy returns GetWorkerWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetRole added in v0.9.0 

func (v *GetWorkerWorker) GetRole() *string

GetRole returns GetWorkerWorker.Role, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetSlug added in v0.10.0 

func (v *GetWorkerWorker) GetSlug() string

GetSlug returns GetWorkerWorker.Slug, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) GetUrn added in v0.10.0 

func (v *GetWorkerWorker) GetUrn() *string

GetUrn returns GetWorkerWorker.Urn, and is useful for accessing the field via an interface.

func (*GetWorkerWorker) MarshalJSON added in v0.9.0 

func (v *GetWorkerWorker) MarshalJSON() ([]byte, error)

func (*GetWorkerWorker) UnmarshalJSON added in v0.9.0 

func (v *GetWorkerWorker) UnmarshalJSON(b []byte) error

type ImportNodeImportNodeImportNodeResult added in v0.6.0 

type ImportNodeImportNodeImportNodeResult struct {
	Status ImportNodeStatus `json:"status"`
	// Reserved for the async path — always null in sync v1.
	JobId *string                                   `json:"jobId"`
	Node  *ImportNodeImportNodeImportNodeResultNode `json:"node"`
}

ImportNodeImportNodeImportNodeResult includes the requested fields of the GraphQL type ImportNodeResult.

func (*ImportNodeImportNodeImportNodeResult) GetJobId added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResult) GetJobId() *string

GetJobId returns ImportNodeImportNodeImportNodeResult.JobId, and is useful for accessing the field via an interface.

func (*ImportNodeImportNodeImportNodeResult) GetNode added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResult) GetNode() *ImportNodeImportNodeImportNodeResultNode

GetNode returns ImportNodeImportNodeImportNodeResult.Node, and is useful for accessing the field via an interface.

func (*ImportNodeImportNodeImportNodeResult) GetStatus added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResult) GetStatus() ImportNodeStatus

GetStatus returns ImportNodeImportNodeImportNodeResult.Status, and is useful for accessing the field via an interface.

type ImportNodeImportNodeImportNodeResultNode added in v0.6.0 

type ImportNodeImportNodeImportNodeResultNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType  string `json:"nodeType"`
	UpdatedAt string `json:"updatedAt"`
}

ImportNodeImportNodeImportNodeResultNode includes the requested fields of the GraphQL type Node.

func (*ImportNodeImportNodeImportNodeResultNode) GetId added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResultNode) GetId() string

GetId returns ImportNodeImportNodeImportNodeResultNode.Id, and is useful for accessing the field via an interface.

func (*ImportNodeImportNodeImportNodeResultNode) GetLoc added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResultNode) GetLoc() string

GetLoc returns ImportNodeImportNodeImportNodeResultNode.Loc, and is useful for accessing the field via an interface.

func (*ImportNodeImportNodeImportNodeResultNode) GetMemoryId added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResultNode) GetMemoryId() string

GetMemoryId returns ImportNodeImportNodeImportNodeResultNode.MemoryId, and is useful for accessing the field via an interface.

func (*ImportNodeImportNodeImportNodeResultNode) GetName added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResultNode) GetName() string

GetName returns ImportNodeImportNodeImportNodeResultNode.Name, and is useful for accessing the field via an interface.

func (*ImportNodeImportNodeImportNodeResultNode) GetNodeType added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResultNode) GetNodeType() string

GetNodeType returns ImportNodeImportNodeImportNodeResultNode.NodeType, and is useful for accessing the field via an interface.

func (*ImportNodeImportNodeImportNodeResultNode) GetUpdatedAt added in v0.6.0 

func (v *ImportNodeImportNodeImportNodeResultNode) GetUpdatedAt() string

GetUpdatedAt returns ImportNodeImportNodeImportNodeResultNode.UpdatedAt, and is useful for accessing the field via an interface.

type ImportNodeInput added in v0.6.0 

type ImportNodeInput struct {
	// App to run the task under — PK or URN. Falls back to the caller's active App. Only meaningful with taskRef.
	AppRef *string `json:"appRef,omitempty"`
	// Inline source content (e.g. the Web Clipper's authenticated-DOM capture). XOR with 'url'.
	Content *string `json:"content,omitempty"`
	// MIME type of 'content': text/html (DEFAULT here — unlike createNode) converts to Markdown at the write seam; text/markdown stores as-is; application/pdf extracts a PDF's text layer to Markdown ('content' must be raw base64 — a PDF is binary; scanned/image-only PDFs error). Ignored on the url path (always HTML).
	ContentType *string `json:"contentType,omitempty"`
	// Target loc within 'memoryId'. XOR with 'nodeUrn'.
	Loc *string `json:"loc,omitempty"`
	// Target memory (ID or fully-qualified URN), with 'loc'. XOR with 'nodeUrn'.
	MemoryId *string `json:"memoryId,omitempty"`
	// Display name. Default: the extracted page/article/document title; on a re-import of an existing node the current name is preserved; a fresh create without either falls back to the loc leaf.
	Name *string `json:"name,omitempty"`
	// Default 'webpage' (or 'info' when contentType is application/pdf).
	NodeType *string `json:"nodeType,omitempty"`
	// Fully-qualified node URN naming the target (existing or new). XOR with memoryId+loc.
	NodeUrn *string `json:"nodeUrn,omitempty"`
	// Merged provenance metadata; the server sets properties.url on the url path when absent (properties.title is filled from the extracted title by the write seam).
	Properties *json.RawMessage `json:"properties,omitempty"`
	// Extra template args merged into the task run's eventData (only meaningful with taskRef).
	TaskArgs *json.RawMessage `json:"taskArgs,omitempty"`
	// Task node to run against the imported node once stored (#528) — PK or fully-qualified URN. Presence triggers a MANUAL app run; the result envelope is FETCH_PENDING + jobId (poll appRun(ref:)). The imported node's URN is passed to the task as eventData.importedNodeUrn.
	TaskRef *string `json:"taskRef,omitempty"`
	// Source URL (http/https) — fetched server-side, SSRF-guarded, WITHOUT user credentials.
	Url *string `json:"url,omitempty"`
}

Input for importNode (#457). Target: 'nodeUrn' XOR ('memoryId' + 'loc') — the URN may name a not-yet-existing node (import creates it). Source: exactly one of 'url' | 'content'.

func (*ImportNodeInput) GetAppRef added in v0.7.0 

func (v *ImportNodeInput) GetAppRef() *string

GetAppRef returns ImportNodeInput.AppRef, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetContent added in v0.6.0 

func (v *ImportNodeInput) GetContent() *string

GetContent returns ImportNodeInput.Content, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetContentType added in v0.6.0 

func (v *ImportNodeInput) GetContentType() *string

GetContentType returns ImportNodeInput.ContentType, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetLoc added in v0.6.0 

func (v *ImportNodeInput) GetLoc() *string

GetLoc returns ImportNodeInput.Loc, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetMemoryId added in v0.6.0 

func (v *ImportNodeInput) GetMemoryId() *string

GetMemoryId returns ImportNodeInput.MemoryId, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetName added in v0.6.0 

func (v *ImportNodeInput) GetName() *string

GetName returns ImportNodeInput.Name, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetNodeType added in v0.6.0 

func (v *ImportNodeInput) GetNodeType() *string

GetNodeType returns ImportNodeInput.NodeType, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetNodeUrn added in v0.6.0 

func (v *ImportNodeInput) GetNodeUrn() *string

GetNodeUrn returns ImportNodeInput.NodeUrn, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetProperties added in v0.6.0 

func (v *ImportNodeInput) GetProperties() *json.RawMessage

GetProperties returns ImportNodeInput.Properties, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetTaskArgs added in v0.7.0 

func (v *ImportNodeInput) GetTaskArgs() *json.RawMessage

GetTaskArgs returns ImportNodeInput.TaskArgs, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetTaskRef added in v0.7.0 

func (v *ImportNodeInput) GetTaskRef() *string

GetTaskRef returns ImportNodeInput.TaskRef, and is useful for accessing the field via an interface.

func (*ImportNodeInput) GetUrl added in v0.6.0 

func (v *ImportNodeInput) GetUrl() *string

GetUrl returns ImportNodeInput.Url, and is useful for accessing the field via an interface.

type ImportNodeResponse added in v0.6.0 

type ImportNodeResponse struct {
	// Import external content into a node (#457, sync v1). Source: exactly one
	// of 'url' (server-fetched inline, SSRF-guarded, Readability-extracted,
	// ~30s budget — the fetch carries NO user credentials, so authenticated
	// pages must come as 'content') or 'content' (client-captured, e.g. the
	// Web Clipper's authenticated DOM). Target: 'nodeUrn' XOR ('memoryId' +
	// 'loc'); an existing node is updated IN PLACE (NodeRevision snapshot is
	// the undo), a missing one is created. HTML converts to Markdown at the
	// write seam (contentType defaults to text/html here, unlike createNode).
	ImportNode *ImportNodeImportNodeImportNodeResult `json:"importNode"`
}

ImportNodeResponse is returned by ImportNode on success.

func ImportNode added in v0.6.0 

func ImportNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *ImportNodeInput,
) (data_ *ImportNodeResponse, err_ error)

Import external content into a node (cor:api:130 / importNode #457, #488). Target: $nodeUrn XOR ($memoryId + $loc) — the URN may name a not-yet-existing node (import creates it). Source: exactly one of $url or $content; for application/pdf the $content is raw base64. Every input field is optional, and the server reads an *omitted* field differently from an explicit null — nil pointers must be omitted from the wire, hence the per-field omitempty annotations. Backs `hadron node import`'s content mode.

func (*ImportNodeResponse) GetImportNode added in v0.6.0 

func (v *ImportNodeResponse) GetImportNode() *ImportNodeImportNodeImportNodeResult

GetImportNode returns ImportNodeResponse.ImportNode, and is useful for accessing the field via an interface.

type ImportNodeStatus added in v0.6.0 

type ImportNodeStatus string

importNode outcome. Sync v1 always returns STORED with the stored node; FETCH_PENDING + jobId are RESERVED for the future async url path (same API shape, no breaking change when it lands). 

const (
	ImportNodeStatusFetchPending ImportNodeStatus = "FETCH_PENDING"
	ImportNodeStatusStored       ImportNodeStatus = "STORED"
)

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload added in v0.9.0 

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload struct {
	AppAgent *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent `json:"appAgent"`
}

InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload includes the requested fields of the GraphQL type InstallAgentIntoAppPayload. The GraphQL type's documentation follows.

Return shape for the installAgentIntoApp mutation. Wraps the new AppAgent row so callers can read its audit fields without re-querying.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload) GetAppAgent added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload) GetAppAgent() *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent

GetAppAgent returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload.AppAgent, and is useful for accessing the field via an interface.

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent added in v0.9.0 

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent struct {
	CreatedAt string `json:"createdAt"`
	// The installed Agent when this caller may read its definition; an installation license alone does not grant that read.
	Agent *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent `json:"agent"`
	// The App when this caller may read it; strict user ownership still applies.
	App *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp `json:"app"`
}

InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent includes the requested fields of the GraphQL type AppAgent. The GraphQL type's documentation follows.

023-app-shape US1: the App↔Agent N:M join. Reintroduced after spec 008 collapsed it; per FR-003 it carries NO role column (system memory is read-only to every App) and per FR-001 it carries NO trainingMode column (training mode is per-App, on App.trainingMode).

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent) GetAgent added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent) GetAgent() *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent

GetAgent returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent.Agent, and is useful for accessing the field via an interface.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent) GetApp added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent) GetApp() *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp

GetApp returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent.App, and is useful for accessing the field via an interface.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent) GetCreatedAt added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent) GetCreatedAt() string

GetCreatedAt returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgent.CreatedAt, and is useful for accessing the field via an interface.

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent added in v0.9.0 

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent struct {
	Id   string `json:"id"`
	Urn  string `json:"urn"`
	Name string `json:"name"`
	// Persona role - free string with conventions ('backend-engineer').
	PersonaRole *string `json:"personaRole"`
}

InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetId added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetId() string

GetId returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent.Id, and is useful for accessing the field via an interface.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetName added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetName() string

GetName returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent.Name, and is useful for accessing the field via an interface.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetPersonaRole added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetPersonaRole() *string

GetPersonaRole returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetUrn added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent) GetUrn() string

GetUrn returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent.Urn, and is useful for accessing the field via an interface.

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp added in v0.9.0 

type InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp struct {
	Id   string `json:"id"`
	Urn  string `json:"urn"`
	Name string `json:"name"`
}

InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp includes the requested fields of the GraphQL type App. The GraphQL type's documentation follows.

A runtime caller identity owned by exactly one Organization or User. It owns long-lived App Keys and installs Agents through the AppAgent N:M join: one App may install many Agents, and one Agent may be installed in many Apps. The singular agentId / agent fields below are soft-deprecated convenience reads of the first install, not a direct foreign key.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp) GetId added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp) GetId() string

GetId returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp.Id, and is useful for accessing the field via an interface.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp) GetName added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp) GetName() string

GetName returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp.Name, and is useful for accessing the field via an interface.

func (*InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp) GetUrn added in v0.9.0 

func (v *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp) GetUrn() string

GetUrn returns InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentApp.Urn, and is useful for accessing the field via an interface.

type InstallAgentIntoAppResponse added in v0.9.0 

type InstallAgentIntoAppResponse struct {
	// Install an Agent into an App (023-app-shape US1). Creates an AppAgent
	// row joining the two. An App can have multiple Agents installed; one
	// credential addresses all of them.
	//
	// This is the ONE operation that attaches an EXISTING Agent to an EXISTING
	// App — distinct from createApp (which makes a NEW App from an Agent). It
	// is therefore also the re-attach that cor:dmo:050:03 promises: detaching an
	// Agent retains the memories accumulated under that App-and-Agent pairing as
	// orphans, and installing the Agent again is what makes them reachable.
	// Under cor:agt:020:01 the AppAgent join is a team's install ROSTER (which
	// agents are available); the App's STAFF are its Workers, cast from
	// installed agents with castWorker. Worker rows survive uninstall
	// (cor:dmo:050:11) — uninstalling severs future casting, not history.
	//
	// Rejects with code DUPLICATE_APP_AGENT when the Agent is already
	// installed in the App.
	//
	// Authorization: the owner of a user-owned App, or an org member with
	// CONTRIBUTOR+ on an org-owned App's org (platform admins included). NOT
	// plain AppMembers: installing an existing Agent is itself a read grant on
	// that Agent's design — its system memory becomes readable from every App
	// context, and the returned Agent carries its systemPrompt — so this gate
	// stays at the level that can already read the org's Agents.
	//
	// Accepts the entity's ID or URN for both appRef and agentRef. Optional
	// trainingMode flag updates the per-App training flag (applies to
	// every installed Agent — training mode is per-App, not per-Agent,
	// per spec 023 FR-001).
	InstallAgentIntoApp *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload `json:"installAgentIntoApp"`
}

InstallAgentIntoAppResponse is returned by InstallAgentIntoApp on success.

func InstallAgentIntoApp added in v0.9.0 

func InstallAgentIntoApp(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	agentRef string,
	trainingMode *bool,
) (data_ *InstallAgentIntoAppResponse, err_ error)

#389: attach / detach an existing Agent to an existing App — the AppAgent join (spec 023 US1, cor:dmo:050:03). `createApp` makes a NEW App from an Agent; these two are the only way to compose the roster of one you already have, and until now only raw GraphQL reached them, which is why hadron-server#952 read as "no surface attaches an existing Agent".

trainingMode is omitempty because it is PER-APP, not per-Agent (spec 023 FR-001): sending it always would silently re-set the flag for every installed Agent on an add that never meant to touch it.

func (*InstallAgentIntoAppResponse) GetInstallAgentIntoApp added in v0.9.0 

func (v *InstallAgentIntoAppResponse) GetInstallAgentIntoApp() *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayload

GetInstallAgentIntoApp returns InstallAgentIntoAppResponse.InstallAgentIntoApp, and is useful for accessing the field via an interface.

type InvitationFields added in v0.7.0 

type InvitationFields struct {
	Id              string  `json:"id"`
	Slug            string  `json:"slug"`
	Email           *string `json:"email"`
	Name            *string `json:"name"`
	GithubUsername  *string `json:"githubUsername"`
	MemberRole      Role    `json:"memberRole"`
	OrganizationId  *string `json:"organizationId"`
	MaxActivations  *int    `json:"maxActivations"`
	ActivationCount int     `json:"activationCount"`
	ExpiresAt       *string `json:"expiresAt"`
	AcceptedAt      *string `json:"acceptedAt"`
	CreatedAt       string  `json:"createdAt"`
}

InvitationFields includes the GraphQL fields of UserInvitation requested by the fragment InvitationFields. The GraphQL type's documentation follows.

Invitation to join the platform (and optionally an organization)

func (*InvitationFields) GetAcceptedAt added in v0.7.0 

func (v *InvitationFields) GetAcceptedAt() *string

GetAcceptedAt returns InvitationFields.AcceptedAt, and is useful for accessing the field via an interface.

func (*InvitationFields) GetActivationCount added in v0.7.0 

func (v *InvitationFields) GetActivationCount() int

GetActivationCount returns InvitationFields.ActivationCount, and is useful for accessing the field via an interface.

func (*InvitationFields) GetCreatedAt added in v0.7.0 

func (v *InvitationFields) GetCreatedAt() string

GetCreatedAt returns InvitationFields.CreatedAt, and is useful for accessing the field via an interface.

func (*InvitationFields) GetEmail added in v0.7.0 

func (v *InvitationFields) GetEmail() *string

GetEmail returns InvitationFields.Email, and is useful for accessing the field via an interface.

func (*InvitationFields) GetExpiresAt added in v0.7.0 

func (v *InvitationFields) GetExpiresAt() *string

GetExpiresAt returns InvitationFields.ExpiresAt, and is useful for accessing the field via an interface.

func (*InvitationFields) GetGithubUsername added in v0.7.0 

func (v *InvitationFields) GetGithubUsername() *string

GetGithubUsername returns InvitationFields.GithubUsername, and is useful for accessing the field via an interface.

func (*InvitationFields) GetId added in v0.7.0 

func (v *InvitationFields) GetId() string

GetId returns InvitationFields.Id, and is useful for accessing the field via an interface.

func (*InvitationFields) GetMaxActivations added in v0.7.0 

func (v *InvitationFields) GetMaxActivations() *int

GetMaxActivations returns InvitationFields.MaxActivations, and is useful for accessing the field via an interface.

func (*InvitationFields) GetMemberRole added in v0.7.0 

func (v *InvitationFields) GetMemberRole() Role

GetMemberRole returns InvitationFields.MemberRole, and is useful for accessing the field via an interface.

func (*InvitationFields) GetName added in v0.7.0 

func (v *InvitationFields) GetName() *string

GetName returns InvitationFields.Name, and is useful for accessing the field via an interface.

func (*InvitationFields) GetOrganizationId added in v0.7.0 

func (v *InvitationFields) GetOrganizationId() *string

GetOrganizationId returns InvitationFields.OrganizationId, and is useful for accessing the field via an interface.

func (*InvitationFields) GetSlug added in v0.7.0 

func (v *InvitationFields) GetSlug() string

GetSlug returns InvitationFields.Slug, and is useful for accessing the field via an interface.

type LinkMemoryToUserLinkMemoryToUserMemory added in v0.9.0 

type LinkMemoryToUserLinkMemoryToUserMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

LinkMemoryToUserLinkMemoryToUserMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetClass added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetClass() MemoryClass

GetClass returns LinkMemoryToUserLinkMemoryToUserMemory.Class, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetId added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetId() string

GetId returns LinkMemoryToUserLinkMemoryToUserMemory.Id, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetIsEncrypted added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetIsEncrypted() bool

GetIsEncrypted returns LinkMemoryToUserLinkMemoryToUserMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetMaxRevCount added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetMaxRevCount() int

GetMaxRevCount returns LinkMemoryToUserLinkMemoryToUserMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetName added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetName() string

GetName returns LinkMemoryToUserLinkMemoryToUserMemory.Name, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetOrganizationId added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetOrganizationId() *string

GetOrganizationId returns LinkMemoryToUserLinkMemoryToUserMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetShortDescription added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetShortDescription() *string

GetShortDescription returns LinkMemoryToUserLinkMemoryToUserMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetUpdatedAt added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetUpdatedAt() string

GetUpdatedAt returns LinkMemoryToUserLinkMemoryToUserMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetUrn added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetUrn() string

GetUrn returns LinkMemoryToUserLinkMemoryToUserMemory.Urn, and is useful for accessing the field via an interface.

func (*LinkMemoryToUserLinkMemoryToUserMemory) GetVisibility added in v0.9.0 

func (v *LinkMemoryToUserLinkMemoryToUserMemory) GetVisibility() *MemoryVisibility

GetVisibility returns LinkMemoryToUserLinkMemoryToUserMemory.Visibility, and is useful for accessing the field via an interface.

type LinkMemoryToUserResponse added in v0.9.0 

type LinkMemoryToUserResponse struct {
	// Link an anonymous memory to a real user (converts session memory
	// ownership). Providing dataKey encrypts the memory in place atomically
	// with the link.
	//
	// Accepts the entity's ID or URN.
	LinkMemoryToUser *LinkMemoryToUserLinkMemoryToUserMemory `json:"linkMemoryToUser"`
}

LinkMemoryToUserResponse is returned by LinkMemoryToUser on success.

func LinkMemoryToUser added in v0.9.0 

func LinkMemoryToUser(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryId string,
	externalUserId string,
	dataKey *string,
) (data_ *LinkMemoryToUserResponse, err_ error)

Promote an anonymous/session memory to a registered user (#75, descoped from #57). Backs `hadron memory link-user`.

App-key only: the server gates on ctx.appId, so a user PAT is refused. The memory must be a user/anonymous memory in the App's own organization.

externalUserId is the App's own identifier for the end user; the server resolves it to an existing app-scoped user or provisions one (unless the App sets createUserPermission=DENY).

Two side effects the caller must see, hence selecting urn and isEncrypted: the memory's URN is RE-MINTED as a fresh flat v2 urn (the old one stops resolving), and passing dataKey encrypts every node in place and lands the memory as class='private' owned by that user.

func (*LinkMemoryToUserResponse) GetLinkMemoryToUser added in v0.9.0 

func (v *LinkMemoryToUserResponse) GetLinkMemoryToUser() *LinkMemoryToUserLinkMemoryToUserMemory

GetLinkMemoryToUser returns LinkMemoryToUserResponse.LinkMemoryToUser, and is useful for accessing the field via an interface.

type MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState added in v0.18.0 

type MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState struct {
	WorkerId    string `json:"workerId"`
	ChannelId   string `json:"channelId"`
	LastSeenSeq int    `json:"lastSeenSeq"`
}

MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState includes the requested fields of the GraphQL type OwnTeamChatReadState. The GraphQL type's documentation follows.

#1353 — the exact Worker/Channel cursor advanced by markOwnTeamChatRead.

func (*MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState) GetChannelId added in v0.18.0 

func (v *MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState) GetChannelId() string

GetChannelId returns MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState.ChannelId, and is useful for accessing the field via an interface.

func (*MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState) GetLastSeenSeq added in v0.18.0 

func (v *MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState) GetLastSeenSeq() int

GetLastSeenSeq returns MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState.LastSeenSeq, and is useful for accessing the field via an interface.

func (*MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState) GetWorkerId added in v0.18.0 

func (v *MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState) GetWorkerId() string

GetWorkerId returns MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState.WorkerId, and is useful for accessing the field via an interface.

type MarkOwnTeamChatReadResponse added in v0.18.0 

type MarkOwnTeamChatReadResponse struct {
	// #1353: explicitly advance the cursor owned by one exact,
	// caller-owned live Worker session on one readable registered Channel.
	// Shares the MCP mark-read helper; unlike advanceChannelReadState this door
	// requires that session. Monotonic; a seq beyond the captured Channel
	// watermark is refused.
	MarkOwnTeamChatRead *MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState `json:"markOwnTeamChatRead"`
}

MarkOwnTeamChatReadResponse is returned by MarkOwnTeamChatRead on success.

func MarkOwnTeamChatRead added in v0.18.0 

func MarkOwnTeamChatRead(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	sessionRef string,
	channelRef string,
	seq int,
) (data_ *MarkOwnTeamChatReadResponse, err_ error)

`hadron team chat mark-read`: advance the bound worker's own cursor. The GraphQL twin of hadron_team_chat_mark_read (same server helper, pinned to one caller-owned live session) — deliberately NOT the wider advanceChannelReadState, which is not pinned to one session.

func (*MarkOwnTeamChatReadResponse) GetMarkOwnTeamChatRead added in v0.18.0 

func (v *MarkOwnTeamChatReadResponse) GetMarkOwnTeamChatRead() *MarkOwnTeamChatReadMarkOwnTeamChatReadOwnTeamChatReadState

GetMarkOwnTeamChatRead returns MarkOwnTeamChatReadResponse.MarkOwnTeamChatRead, and is useful for accessing the field via an interface.

type McpServerFields added in v0.7.0 

type McpServerFields struct {
	Id             string `json:"id"`
	OrganizationId string `json:"organizationId"`
	// Run-tool name segment (mcp__<slug>__<tool>); lowercase [a-z0-9-], unique per org, immutable.
	Slug string `json:"slug"`
	Name string `json:"name"`
	// Streamable-HTTP MCP endpoint URL.
	Url string `json:"url"`
	// Exposed-tool allowlist; empty = every tool the server advertises.
	ToolAllowlist []string `json:"toolAllowlist"`
	// Whether encrypted static headers are stored (the values are never returned).
	HasHeaders bool `json:"hasHeaders"`
	// Disabled servers fail run-tool resolution loud, same as an unregistered slug.
	Enabled   bool   `json:"enabled"`
	CreatedAt string `json:"createdAt"`
	UpdatedAt string `json:"updatedAt"`
}

McpServerFields includes the GraphQL fields of McpServer requested by the fragment McpServerFields. The GraphQL type's documentation follows.

One registered EXTERNAL MCP server (hadrontool-mcp conduit registry). Org-owned. Static auth headers are encrypted at rest and WRITE-ONLY: no field here ever returns them — hasHeaders is all a reader gets. The row grants nothing by itself; every run-time call walks the policy chain as 'tool.mcp__<slug>__<tool>' plus the run's action budget.

func (*McpServerFields) GetCreatedAt added in v0.7.0 

func (v *McpServerFields) GetCreatedAt() string

GetCreatedAt returns McpServerFields.CreatedAt, and is useful for accessing the field via an interface.

func (*McpServerFields) GetEnabled added in v0.7.0 

func (v *McpServerFields) GetEnabled() bool

GetEnabled returns McpServerFields.Enabled, and is useful for accessing the field via an interface.

func (*McpServerFields) GetHasHeaders added in v0.7.0 

func (v *McpServerFields) GetHasHeaders() bool

GetHasHeaders returns McpServerFields.HasHeaders, and is useful for accessing the field via an interface.

func (*McpServerFields) GetId added in v0.7.0 

func (v *McpServerFields) GetId() string

GetId returns McpServerFields.Id, and is useful for accessing the field via an interface.

func (*McpServerFields) GetName added in v0.7.0 

func (v *McpServerFields) GetName() string

GetName returns McpServerFields.Name, and is useful for accessing the field via an interface.

func (*McpServerFields) GetOrganizationId added in v0.7.0 

func (v *McpServerFields) GetOrganizationId() string

GetOrganizationId returns McpServerFields.OrganizationId, and is useful for accessing the field via an interface.

func (*McpServerFields) GetSlug added in v0.7.0 

func (v *McpServerFields) GetSlug() string

GetSlug returns McpServerFields.Slug, and is useful for accessing the field via an interface.

func (*McpServerFields) GetToolAllowlist added in v0.7.0 

func (v *McpServerFields) GetToolAllowlist() []string

GetToolAllowlist returns McpServerFields.ToolAllowlist, and is useful for accessing the field via an interface.

func (*McpServerFields) GetUpdatedAt added in v0.7.0 

func (v *McpServerFields) GetUpdatedAt() string

GetUpdatedAt returns McpServerFields.UpdatedAt, and is useful for accessing the field via an interface.

func (*McpServerFields) GetUrl added in v0.7.0 

func (v *McpServerFields) GetUrl() string

GetUrl returns McpServerFields.Url, and is useful for accessing the field via an interface.

type McpServerMcpServer added in v0.7.0 

type McpServerMcpServer struct {
	McpServerFields `json:"-"`
}

McpServerMcpServer includes the requested fields of the GraphQL type McpServer. The GraphQL type's documentation follows.

One registered EXTERNAL MCP server (hadrontool-mcp conduit registry). Org-owned. Static auth headers are encrypted at rest and WRITE-ONLY: no field here ever returns them — hasHeaders is all a reader gets. The row grants nothing by itself; every run-time call walks the policy chain as 'tool.mcp__<slug>__<tool>' plus the run's action budget.

func (*McpServerMcpServer) GetCreatedAt added in v0.7.0 

func (v *McpServerMcpServer) GetCreatedAt() string

GetCreatedAt returns McpServerMcpServer.CreatedAt, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetEnabled added in v0.7.0 

func (v *McpServerMcpServer) GetEnabled() bool

GetEnabled returns McpServerMcpServer.Enabled, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetHasHeaders added in v0.7.0 

func (v *McpServerMcpServer) GetHasHeaders() bool

GetHasHeaders returns McpServerMcpServer.HasHeaders, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetId added in v0.7.0 

func (v *McpServerMcpServer) GetId() string

GetId returns McpServerMcpServer.Id, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetName added in v0.7.0 

func (v *McpServerMcpServer) GetName() string

GetName returns McpServerMcpServer.Name, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetOrganizationId added in v0.7.0 

func (v *McpServerMcpServer) GetOrganizationId() string

GetOrganizationId returns McpServerMcpServer.OrganizationId, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetSlug added in v0.7.0 

func (v *McpServerMcpServer) GetSlug() string

GetSlug returns McpServerMcpServer.Slug, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetToolAllowlist added in v0.7.0 

func (v *McpServerMcpServer) GetToolAllowlist() []string

GetToolAllowlist returns McpServerMcpServer.ToolAllowlist, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetUpdatedAt added in v0.7.0 

func (v *McpServerMcpServer) GetUpdatedAt() string

GetUpdatedAt returns McpServerMcpServer.UpdatedAt, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) GetUrl added in v0.7.0 

func (v *McpServerMcpServer) GetUrl() string

GetUrl returns McpServerMcpServer.Url, and is useful for accessing the field via an interface.

func (*McpServerMcpServer) MarshalJSON added in v0.7.0 

func (v *McpServerMcpServer) MarshalJSON() ([]byte, error)

func (*McpServerMcpServer) UnmarshalJSON added in v0.7.0 

func (v *McpServerMcpServer) UnmarshalJSON(b []byte) error

type McpServerResponse added in v0.7.0 

type McpServerResponse struct {
	// Fetch one registered external MCP server by id. Returns null when the
	// row does not exist OR the caller is not a member of its org — no
	// existence disclosure.
	McpServer *McpServerMcpServer `json:"mcpServer"`
}

McpServerResponse is returned by McpServer on success.

func McpServer added in v0.7.0 

func McpServer(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *McpServerResponse, err_ error)

func (*McpServerResponse) GetMcpServer added in v0.7.0 

func (v *McpServerResponse) GetMcpServer() *McpServerMcpServer

GetMcpServer returns McpServerResponse.McpServer, and is useful for accessing the field via an interface.

type McpServerToolsMcpServerToolsMcpServerTool added in v0.7.0 

type McpServerToolsMcpServerToolsMcpServerTool struct {
	// The tool's name on the external server.
	Name        string  `json:"name"`
	Description *string `json:"description"`
	// The run-tool / policy name: mcp__<slug>__<name>.
	RunToolName string `json:"runToolName"`
	// The tool's argument JSON Schema, passed through verbatim.
	InputSchema *json.RawMessage `json:"inputSchema"`
}

McpServerToolsMcpServerToolsMcpServerTool includes the requested fields of the GraphQL type McpServerTool. The GraphQL type's documentation follows.

One tool an external MCP server advertises, as admitted by the registry row (allowlist + name grammar + length cap applied) — what this query returns IS what a run can declare in data.tools.

func (*McpServerToolsMcpServerToolsMcpServerTool) GetDescription added in v0.7.0 

func (v *McpServerToolsMcpServerToolsMcpServerTool) GetDescription() *string

GetDescription returns McpServerToolsMcpServerToolsMcpServerTool.Description, and is useful for accessing the field via an interface.

func (*McpServerToolsMcpServerToolsMcpServerTool) GetInputSchema added in v0.7.0 

func (v *McpServerToolsMcpServerToolsMcpServerTool) GetInputSchema() *json.RawMessage

GetInputSchema returns McpServerToolsMcpServerToolsMcpServerTool.InputSchema, and is useful for accessing the field via an interface.

func (*McpServerToolsMcpServerToolsMcpServerTool) GetName added in v0.7.0 

func (v *McpServerToolsMcpServerToolsMcpServerTool) GetName() string

GetName returns McpServerToolsMcpServerToolsMcpServerTool.Name, and is useful for accessing the field via an interface.

func (*McpServerToolsMcpServerToolsMcpServerTool) GetRunToolName added in v0.7.0 

func (v *McpServerToolsMcpServerToolsMcpServerTool) GetRunToolName() string

GetRunToolName returns McpServerToolsMcpServerToolsMcpServerTool.RunToolName, and is useful for accessing the field via an interface.

type McpServerToolsResponse added in v0.7.0 

type McpServerToolsResponse struct {
	// Live tools/list passthrough for one registered server (org member) —
	// what authors browse to pick data.tools entries. Applies the same
	// admissibility filter as run-tool materialization, so what it returns
	// IS what a run can call: a disabled server errors with
	// MCP_SERVER_DISABLED rather than listing uncallable tools. Null when
	// the row does not exist or the caller is not a member of its org;
	// errors with MCP_TOOL_* codes when the conduit or the external server
	// fails.
	McpServerTools []*McpServerToolsMcpServerToolsMcpServerTool `json:"mcpServerTools"`
}

McpServerToolsResponse is returned by McpServerTools on success.

func McpServerTools added in v0.7.0 

func McpServerTools(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *McpServerToolsResponse, err_ error)

Live tools/list as admitted by the registry row (allowlist + grammar applied); runToolName is the mcp__<slug>__<tool> an author pastes into data.tools.

func (*McpServerToolsResponse) GetMcpServerTools added in v0.7.0 

func (v *McpServerToolsResponse) GetMcpServerTools() []*McpServerToolsMcpServerToolsMcpServerTool

GetMcpServerTools returns McpServerToolsResponse.McpServerTools, and is useful for accessing the field via an interface.

type McpServersMcpServersMcpServersPage added in v0.7.0 

type McpServersMcpServersMcpServersPage struct {
	Items []*McpServersMcpServersMcpServersPageItemsMcpServer `json:"items"`
	Total int                                                 `json:"total"`
}

McpServersMcpServersMcpServersPage includes the requested fields of the GraphQL type McpServersPage. The GraphQL type's documentation follows.

Uniform paginated list shape (cor:api:120).

func (*McpServersMcpServersMcpServersPage) GetItems added in v0.7.0 

func (v *McpServersMcpServersMcpServersPage) GetItems() []*McpServersMcpServersMcpServersPageItemsMcpServer

GetItems returns McpServersMcpServersMcpServersPage.Items, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPage) GetTotal added in v0.7.0 

func (v *McpServersMcpServersMcpServersPage) GetTotal() int

GetTotal returns McpServersMcpServersMcpServersPage.Total, and is useful for accessing the field via an interface.

type McpServersMcpServersMcpServersPageItemsMcpServer added in v0.7.0 

type McpServersMcpServersMcpServersPageItemsMcpServer struct {
	McpServerFields `json:"-"`
}

McpServersMcpServersMcpServersPageItemsMcpServer includes the requested fields of the GraphQL type McpServer. The GraphQL type's documentation follows.

One registered EXTERNAL MCP server (hadrontool-mcp conduit registry). Org-owned. Static auth headers are encrypted at rest and WRITE-ONLY: no field here ever returns them — hasHeaders is all a reader gets. The row grants nothing by itself; every run-time call walks the policy chain as 'tool.mcp__<slug>__<tool>' plus the run's action budget.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetCreatedAt added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetCreatedAt() string

GetCreatedAt returns McpServersMcpServersMcpServersPageItemsMcpServer.CreatedAt, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetEnabled added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetEnabled() bool

GetEnabled returns McpServersMcpServersMcpServersPageItemsMcpServer.Enabled, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetHasHeaders added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetHasHeaders() bool

GetHasHeaders returns McpServersMcpServersMcpServersPageItemsMcpServer.HasHeaders, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetId added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetId() string

GetId returns McpServersMcpServersMcpServersPageItemsMcpServer.Id, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetName added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetName() string

GetName returns McpServersMcpServersMcpServersPageItemsMcpServer.Name, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetOrganizationId added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetOrganizationId() string

GetOrganizationId returns McpServersMcpServersMcpServersPageItemsMcpServer.OrganizationId, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetSlug added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetSlug() string

GetSlug returns McpServersMcpServersMcpServersPageItemsMcpServer.Slug, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetToolAllowlist added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetToolAllowlist() []string

GetToolAllowlist returns McpServersMcpServersMcpServersPageItemsMcpServer.ToolAllowlist, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetUpdatedAt added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetUpdatedAt() string

GetUpdatedAt returns McpServersMcpServersMcpServersPageItemsMcpServer.UpdatedAt, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) GetUrl added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) GetUrl() string

GetUrl returns McpServersMcpServersMcpServersPageItemsMcpServer.Url, and is useful for accessing the field via an interface.

func (*McpServersMcpServersMcpServersPageItemsMcpServer) MarshalJSON added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) MarshalJSON() ([]byte, error)

func (*McpServersMcpServersMcpServersPageItemsMcpServer) UnmarshalJSON added in v0.7.0 

func (v *McpServersMcpServersMcpServersPageItemsMcpServer) UnmarshalJSON(b []byte) error

type McpServersResponse added in v0.7.0 

type McpServersResponse struct {
	// Uniform paginated MCP-server list (cor:api:120). Default scope: the
	// caller's member orgs. orgId follows cor:api:100:01 (member -> that
	// org, non-member -> empty page, no disclosure, no admin bypass).
	// Slug-ascending order (id tiebreak); limit default 50 / cap 200;
	// limit: 0 -> count only.
	McpServers *McpServersMcpServersMcpServersPage `json:"mcpServers"`
}

McpServersResponse is returned by McpServers on success.

func McpServers added in v0.7.0 

func McpServers(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId *string,
	limit *int,
	offset *int,
) (data_ *McpServersResponse, err_ error)

Org-scoped list (uniform { items, total } page).

func (*McpServersResponse) GetMcpServers added in v0.7.0 

func (v *McpServersResponse) GetMcpServers() *McpServersMcpServersMcpServersPage

GetMcpServers returns McpServersResponse.McpServers, and is useful for accessing the field via an interface.

type MeMeUser 

type MeMeUser struct {
	Id             string  `json:"id"`
	Name           *string `json:"name"`
	Email          *string `json:"email"`
	Handle         *string `json:"handle"`
	GithubUsername *string `json:"githubUsername"`
	// Platform roles; an empty list is returned to viewers without personal-field access.
	Roles []Role `json:"roles"`
}

MeMeUser includes the requested fields of the GraphQL type User.

func (*MeMeUser) GetEmail 

func (v *MeMeUser) GetEmail() *string

GetEmail returns MeMeUser.Email, and is useful for accessing the field via an interface.

func (*MeMeUser) GetGithubUsername 

func (v *MeMeUser) GetGithubUsername() *string

GetGithubUsername returns MeMeUser.GithubUsername, and is useful for accessing the field via an interface.

func (*MeMeUser) GetHandle 

func (v *MeMeUser) GetHandle() *string

GetHandle returns MeMeUser.Handle, and is useful for accessing the field via an interface.

func (*MeMeUser) GetId 

func (v *MeMeUser) GetId() string

GetId returns MeMeUser.Id, and is useful for accessing the field via an interface.

func (*MeMeUser) GetName 

func (v *MeMeUser) GetName() *string

GetName returns MeMeUser.Name, and is useful for accessing the field via an interface.

func (*MeMeUser) GetRoles 

func (v *MeMeUser) GetRoles() []Role

GetRoles returns MeMeUser.Roles, and is useful for accessing the field via an interface.

type MeResponse 

type MeResponse struct {
	// Current authenticated user
	Me *MeMeUser `json:"me"`
}

MeResponse is returned by Me on success.

func Me 

func Me(
	ctx_ context.Context,
	client_ graphql.Client,
) (data_ *MeResponse, err_ error)

func (*MeResponse) GetMe 

func (v *MeResponse) GetMe() *MeMeUser

GetMe returns MeResponse.Me, and is useful for accessing the field via an interface.

type MemUserFields added in v0.3.0 

type MemUserFields struct {
	Id     string  `json:"id"`
	Name   *string `json:"name"`
	Email  *string `json:"email"`
	Handle *string `json:"handle"`
}

MemUserFields includes the GraphQL fields of User requested by the fragment MemUserFields.

func (*MemUserFields) GetEmail added in v0.3.0 

func (v *MemUserFields) GetEmail() *string

GetEmail returns MemUserFields.Email, and is useful for accessing the field via an interface.

func (*MemUserFields) GetHandle added in v0.3.0 

func (v *MemUserFields) GetHandle() *string

GetHandle returns MemUserFields.Handle, and is useful for accessing the field via an interface.

func (*MemUserFields) GetId added in v0.3.0 

func (v *MemUserFields) GetId() string

GetId returns MemUserFields.Id, and is useful for accessing the field via an interface.

func (*MemUserFields) GetName added in v0.3.0 

func (v *MemUserFields) GetName() *string

GetName returns MemUserFields.Name, and is useful for accessing the field via an interface.

type MemoriesMemoriesMemoriesPage added in v0.5.1 

type MemoriesMemoriesMemoriesPage struct {
	Total int                                        `json:"total"`
	Items []*MemoriesMemoriesMemoriesPageItemsMemory `json:"items"`
}

MemoriesMemoriesMemoriesPage includes the requested fields of the GraphQL type MemoriesPage.

func (*MemoriesMemoriesMemoriesPage) GetItems added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPage) GetItems() []*MemoriesMemoriesMemoriesPageItemsMemory

GetItems returns MemoriesMemoriesMemoriesPage.Items, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPage) GetTotal added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPage) GetTotal() int

GetTotal returns MemoriesMemoriesMemoriesPage.Total, and is useful for accessing the field via an interface.

type MemoriesMemoriesMemoriesPageItemsMemory added in v0.5.1 

type MemoriesMemoriesMemoriesPageItemsMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
}

MemoriesMemoriesMemoriesPageItemsMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetClass added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetClass() MemoryClass

GetClass returns MemoriesMemoriesMemoriesPageItemsMemory.Class, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetId added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetId() string

GetId returns MemoriesMemoriesMemoriesPageItemsMemory.Id, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetIsEncrypted added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetIsEncrypted() bool

GetIsEncrypted returns MemoriesMemoriesMemoriesPageItemsMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetMaxRevCount added in v0.7.0 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetMaxRevCount() int

GetMaxRevCount returns MemoriesMemoriesMemoriesPageItemsMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetName added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetName() string

GetName returns MemoriesMemoriesMemoriesPageItemsMemory.Name, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetOrganizationId added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetOrganizationId() *string

GetOrganizationId returns MemoriesMemoriesMemoriesPageItemsMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetShortDescription added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetShortDescription() *string

GetShortDescription returns MemoriesMemoriesMemoriesPageItemsMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetUpdatedAt added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetUpdatedAt() string

GetUpdatedAt returns MemoriesMemoriesMemoriesPageItemsMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetUrn added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetUrn() string

GetUrn returns MemoriesMemoriesMemoriesPageItemsMemory.Urn, and is useful for accessing the field via an interface.

func (*MemoriesMemoriesMemoriesPageItemsMemory) GetVisibility added in v0.5.1 

func (v *MemoriesMemoriesMemoriesPageItemsMemory) GetVisibility() *MemoryVisibility

GetVisibility returns MemoriesMemoriesMemoriesPageItemsMemory.Visibility, and is useful for accessing the field via an interface.

type MemoriesResponse added in v0.5.1 

type MemoriesResponse struct {
	// Uniform paginated memory list (#473) — replaces myMemories,
	// publicMemories, and orgSystemMemories.
	//
	// Default scope: the caller's union — (1) their OWN personal/private
	// memories (always; they are user-owned and show in every org context),
	// (2) memories their member orgs own, (3) memories their member orgs
	// subscribe to. Per-user agent memories (userMemoryOfAgentId) are excluded.
	// App-key callers get the union of their installed Agents' memory items.
	//
	// filter.visibility: PUBLIC selects the public marketplace slice instead
	// (every PUBLIC memory — the old publicMemories). filter.memoryClasses
	// restricts to exactly the listed classes; omitted, the noisy agent system
	// class is hidden by default (pass it explicitly to surface system
	// memories, e.g. the old orgSystemMemories = orgId + memoryClasses:
	// [system]).
	//
	// orgId follows cor:api:100:01: member -> the "active organization" view
	// (own personal/private + that org's owned + subscribed memories);
	// non-member -> empty page, no existence disclosure, no admin bypass.
	//
	// Name-ascending order (id tiebreak); limit default 50 / cap 200;
	// limit: 0 -> count only.
	Memories *MemoriesMemoriesMemoriesPage `json:"memories"`
}

MemoriesResponse is returned by Memories on success.

func Memories added in v0.5.1 

func Memories(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *MemoryFilter,
	limit *int,
	offset *int,
) (data_ *MemoriesResponse, err_ error)

Uniform paginated memory list (hadron-server#473) — replaces myMemories. The noisy agent system class is hidden unless filter.memoryClasses names it explicitly; limit is capped at 200 server-side, so whole-scope callers page to exhaustion (api.CollectAll).

func (*MemoriesResponse) GetMemories added in v0.5.1 

func (v *MemoriesResponse) GetMemories() *MemoriesMemoriesMemoriesPage

GetMemories returns MemoriesResponse.Memories, and is useful for accessing the field via an interface.

type MemoriesSharedWithMeMemoriesMemoriesPage added in v0.9.0 

type MemoriesSharedWithMeMemoriesMemoriesPage struct {
	Total int                                                    `json:"total"`
	Items []*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory `json:"items"`
}

MemoriesSharedWithMeMemoriesMemoriesPage includes the requested fields of the GraphQL type MemoriesPage.

func (*MemoriesSharedWithMeMemoriesMemoriesPage) GetItems added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPage) GetItems() []*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory

GetItems returns MemoriesSharedWithMeMemoriesMemoriesPage.Items, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPage) GetTotal added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPage) GetTotal() int

GetTotal returns MemoriesSharedWithMeMemoriesMemoriesPage.Total, and is useful for accessing the field via an interface.

type MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory added in v0.9.0 

type MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int    `json:"maxRevCount"`
	UpdatedAt   string `json:"updatedAt"`
	// The caller's OWN share of this memory (they are the grantee), or
	// null. Grantee-readable — unlike shares (principal / org-admin only),
	// this returns at most the single MemoryShare row keyed
	// (memoryId, callerId), so it never leaks co-grantees. null for a
	// non-grantee or an App-key caller. Lets the portal render
	// Shared-by-@grantor + the role on each shared-with-me row.
	MyShare *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare `json:"myShare"`
}

MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetClass added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetClass() MemoryClass

GetClass returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.Class, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetId added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetId() string

GetId returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.Id, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetIsEncrypted added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetIsEncrypted() bool

GetIsEncrypted returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetMaxRevCount added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetMaxRevCount() int

GetMaxRevCount returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetMyShare added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetMyShare() *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare

GetMyShare returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.MyShare, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetName added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetName() string

GetName returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.Name, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetOrganizationId added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetOrganizationId() *string

GetOrganizationId returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetShortDescription added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetShortDescription() *string

GetShortDescription returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetUpdatedAt added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetUpdatedAt() string

GetUpdatedAt returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetUrn added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetUrn() string

GetUrn returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.Urn, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetVisibility added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory) GetVisibility() *MemoryVisibility

GetVisibility returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemory.Visibility, and is useful for accessing the field via an interface.

type MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare added in v0.9.0 

type MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare struct {
	Role MemoryShareRole `json:"role"`
	// The principal of the Memory (Memory.userId). Per spec 023 FR-019
	// this is always the principal, even when an App backend made the
	// API call on the principal's behalf — that actor is recorded in
	// createdBy instead.
	Grantor *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser `json:"grantor"`
}

MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare includes the requested fields of the GraphQL type MemoryShare. The GraphQL type's documentation follows.

023-app-shape US3: asymmetric cross-user grant on a personal-class Memory. The principal (memory.userId) grants a grantee read/write access. Used for per-pairing isolation patterns (e.g., Alice's personal Memory paired-with-Mentor-A is distinct from her paired-with-Mentor-B Memory, each with its own MemoryShare).

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare) GetGrantor added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare) GetGrantor() *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser

GetGrantor returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare.Grantor, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare) GetRole added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare) GetRole() MemoryShareRole

GetRole returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShare.Role, and is useful for accessing the field via an interface.

type MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser added in v0.9.0 

type MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser struct {
	MemUserFields `json:"-"`
}

MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser includes the requested fields of the GraphQL type User.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetEmail added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetEmail() *string

GetEmail returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser.Email, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetHandle added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetHandle() *string

GetHandle returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser.Handle, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetId added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetId() string

GetId returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser.Id, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetName added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) GetName() *string

GetName returns MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser.Name, and is useful for accessing the field via an interface.

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) MarshalJSON added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) MarshalJSON() ([]byte, error)

func (*MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) UnmarshalJSON added in v0.9.0 

func (v *MemoriesSharedWithMeMemoriesMemoriesPageItemsMemoryMyShareMemoryShareGrantorUser) UnmarshalJSON(b []byte) error

type MemoriesSharedWithMeResponse added in v0.9.0 

type MemoriesSharedWithMeResponse struct {
	// Uniform paginated memory list (#473) — replaces myMemories,
	// publicMemories, and orgSystemMemories.
	//
	// Default scope: the caller's union — (1) their OWN personal/private
	// memories (always; they are user-owned and show in every org context),
	// (2) memories their member orgs own, (3) memories their member orgs
	// subscribe to. Per-user agent memories (userMemoryOfAgentId) are excluded.
	// App-key callers get the union of their installed Agents' memory items.
	//
	// filter.visibility: PUBLIC selects the public marketplace slice instead
	// (every PUBLIC memory — the old publicMemories). filter.memoryClasses
	// restricts to exactly the listed classes; omitted, the noisy agent system
	// class is hidden by default (pass it explicitly to surface system
	// memories, e.g. the old orgSystemMemories = orgId + memoryClasses:
	// [system]).
	//
	// orgId follows cor:api:100:01: member -> the "active organization" view
	// (own personal/private + that org's owned + subscribed memories);
	// non-member -> empty page, no existence disclosure, no admin bypass.
	//
	// Name-ascending order (id tiebreak); limit default 50 / cap 200;
	// limit: 0 -> count only.
	Memories *MemoriesSharedWithMeMemoriesMemoriesPage `json:"memories"`
}

MemoriesSharedWithMeResponse is returned by MemoriesSharedWithMe on success.

func MemoriesSharedWithMe added in v0.9.0 

func MemoriesSharedWithMe(
	ctx_ context.Context,
	client_ graphql.Client,
	limit *int,
	offset *int,
	memoryClasses []MemoryClass,
) (data_ *MemoriesSharedWithMeResponse, err_ error)

The shared-with-me slice (#316): memories the caller was granted via MemoryShare. `sharedWithMe: true` SWITCHES which readable set memories() draws from — it is not part of the caller's owned/org union, so this never returns a memory you own.

A separate operation from Memories on purpose: it selects myShare for the per-row role + grantor (which MemoryFilter.sharedWithMe's own docblock points at for this listing), and every whole-scope caller pages the plain memories() list to exhaustion — a per-row myShare resolution must not ride along there.

func (*MemoriesSharedWithMeResponse) GetMemories added in v0.9.0 

func (v *MemoriesSharedWithMeResponse) GetMemories() *MemoriesSharedWithMeMemoriesMemoriesPage

GetMemories returns MemoriesSharedWithMeResponse.Memories, and is useful for accessing the field via an interface.

type MemoryAssetsMemoryAssetsAssetListResult added in v0.9.0 

type MemoryAssetsMemoryAssetsAssetListResult struct {
	Total   int                                                   `json:"total"`
	HasMore bool                                                  `json:"hasMore"`
	Assets  []*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset `json:"assets"`
}

MemoryAssetsMemoryAssetsAssetListResult includes the requested fields of the GraphQL type AssetListResult.

func (*MemoryAssetsMemoryAssetsAssetListResult) GetAssets added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResult) GetAssets() []*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset

GetAssets returns MemoryAssetsMemoryAssetsAssetListResult.Assets, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResult) GetHasMore added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResult) GetHasMore() bool

GetHasMore returns MemoryAssetsMemoryAssetsAssetListResult.HasMore, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResult) GetTotal added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResult) GetTotal() int

GetTotal returns MemoryAssetsMemoryAssetsAssetListResult.Total, and is useful for accessing the field via an interface.

type MemoryAssetsMemoryAssetsAssetListResultAssetsAsset added in v0.9.0 

type MemoryAssetsMemoryAssetsAssetListResultAssetsAsset struct {
	Id string `json:"id"`
	// The asset's URN, grammar v2 (cor:urn:010:01): hrn:asset:<root>:<mem...>:assets:<asset.id>,
	// emitted by emitAssetUrnV2 from the holding memory's STORED urn.
	//
	// <mem...> is one or more atoms, not always one. A per-user memory urn minted
	// before the #697 Stage-3 flip is still compound (<root>:<agent>:app-user:<id>
	// and friends), and each extra memory atom lengthens the asset URN with it —
	// so the 'assets' marker is not at a fixed offset. A parser recovering the
	// holding memory must take everything between the type word and that marker,
	// never a fixed two-atom prefix. Prefer locating the LAST 'assets' atom and
	// reading the id after it (assetIdFromRef does exactly this).
	//
	// Two degraded shapes a parser must tolerate, both of which really occur:
	// * hrn:asset:unknown:assets:<asset.id> — the holding memory row could not
	// be loaded. Carries no memory identity at all.
	// * <memory.urn>:assets:<asset.id> — the pre-#697 shape, with NO hrn:asset:
	// prefix, served when v2 emission throws (empty, over-length or
	// charset-invalid atom in the stored memory urn). It interpolates the
	// stored memory urn verbatim, which is normally bare (<root>:<slug>), so
	// this shape usually looks like acme.com:docs:assets:<id>.
	//
	// A third oddity is reachable through the NORMAL branch, not a fallback: a
	// legacy memories.urn row that predates the chk_memory_urn_not_prefixed
	// guardrail can still hold a rendered hrn:mem:-prefixed value, and that
	// composes into hrn:asset:hrn:mem:<root>:<slug>:assets:<id>. A prefix strip
	// that assumes one leading type word will mis-read it.
	Urn         string          `json:"urn"`
	Filename    string          `json:"filename"`
	MimeType    string          `json:"mimeType"`
	SizeBytes   int             `json:"sizeBytes"`
	Description *string         `json:"description"`
	ScanStatus  AssetScanStatus `json:"scanStatus"`
	// Engine signature name recorded when the scan verdict was BLOCKED (the row is kept as an audit tombstone; its bytes are deleted). Null otherwise.
	ScanSignature *string `json:"scanSignature"`
	UploadedAt    string  `json:"uploadedAt"`
	// Uploader (User id). Null when the asset was created server-side by an app run (hadron_store_file).
	UploadedBy *string `json:"uploadedBy"`
	DeletedAt  *string `json:"deletedAt"`
	MemoryId   string  `json:"memoryId"`
	// Stable, UNAUTHENTICATED hotlink to the bytes (GET /assets/<id>).
	//
	// Anyone with this URL can fetch the file — there is no read gate on
	// it. A deliberate, temporary posture; see src/api/assetPublic.ts. Do
	// not present it in a UI as though it were access-controlled.
	//
	// Null when the server has no BASE_URL configured (no canonical
	// origin to build an absolute URL from), when the asset is not
	// CLEAN, or when its memory is encrypted — encrypted memories are
	// never hotlinkable, since an anonymous request holds no session key.
	PublicUrl *string `json:"publicUrl"`
}

MemoryAssetsMemoryAssetsAssetListResultAssetsAsset includes the requested fields of the GraphQL type Asset.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetDeletedAt added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetDeletedAt() *string

GetDeletedAt returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.DeletedAt, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetDescription added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetDescription() *string

GetDescription returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.Description, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetFilename added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetFilename() string

GetFilename returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.Filename, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetId added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetId() string

GetId returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.Id, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetMemoryId added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetMemoryId() string

GetMemoryId returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.MemoryId, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetMimeType added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetMimeType() string

GetMimeType returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.MimeType, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetPublicUrl added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetPublicUrl() *string

GetPublicUrl returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.PublicUrl, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetScanSignature added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetScanSignature() *string

GetScanSignature returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.ScanSignature, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetScanStatus added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetScanStatus() AssetScanStatus

GetScanStatus returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.ScanStatus, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetSizeBytes added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetSizeBytes() int

GetSizeBytes returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.SizeBytes, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetUploadedAt added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetUploadedAt() string

GetUploadedAt returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.UploadedAt, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetUploadedBy added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetUploadedBy() *string

GetUploadedBy returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.UploadedBy, and is useful for accessing the field via an interface.

func (*MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetUrn added in v0.9.0 

func (v *MemoryAssetsMemoryAssetsAssetListResultAssetsAsset) GetUrn() string

GetUrn returns MemoryAssetsMemoryAssetsAssetListResultAssetsAsset.Urn, and is useful for accessing the field via an interface.

type MemoryAssetsResponse added in v0.9.0 

type MemoryAssetsResponse struct {
	// v2 (spec 006) — memory-addressed listing. Returns every asset
	// attached to the memory; the gate is the memory's read access. The
	// replacement for agentAssets in the v2 surface.
	//
	// Set mine: true to narrow to the caller's own uploads — a filter on
	// top of the read gate, not a substitute for it.
	//
	// Accepts the entity's ID or URN.
	MemoryAssets *MemoryAssetsMemoryAssetsAssetListResult `json:"memoryAssets"`
}

MemoryAssetsResponse is returned by MemoryAssets on success.

func MemoryAssets added in v0.9.0 

func MemoryAssets(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryId string,
	mimeType *string,
	mine *bool,
	includeDeleted *bool,
	skip *int,
	count *int,
) (data_ *MemoryAssetsResponse, err_ error)

Memory-addressed asset listing (the v2 surface; the older agentAssets is agent-scoped and not wired). Listing is gated on READ access to the holding memory — it used to filter `uploadedBy: caller`, which is why #359 recorded cross-uploader listing as blocked; that widening has since landed.

There is deliberately NO unscoped variant: memoryId is required, so "every asset I can read" has no server surface and the CLI does not fake one by fanning out.

func (*MemoryAssetsResponse) GetMemoryAssets added in v0.9.0 

func (v *MemoryAssetsResponse) GetMemoryAssets() *MemoryAssetsMemoryAssetsAssetListResult

GetMemoryAssets returns MemoryAssetsResponse.MemoryAssets, and is useful for accessing the field via an interface.

type MemoryClass 

type MemoryClass string
const (
	MemoryClassApp MemoryClass = "app"
	// 023-app-shape US4: team-shared memory with symmetric membership.
	// Governed by a list of MemoryMember rows (each with reader/writer/
	// owner role) — no single owner field on Memory. Closes the
	// Company Brain gap that wasn't covered by the four legacy classes.
	MemoryClassGroup     MemoryClass = "group"
	MemoryClassKnowledge MemoryClass = "knowledge"
	MemoryClassPersonal  MemoryClass = "personal"
	// Single-owner, owner-only memory — no MemoryShare path (not
	// shareable), no ADMIN/OWNER bypass. Spec 034 (hadron-server #242)
	// made it user-creatable via createMemory: free-standing (no
	// app/agent) or app-scoped. May opt into encrypt-at-rest
	// (the private CLASS marks it; visibility is NULL), but the encryption
	// implementation itself is a deferred follow-up — do NOT rely on
	// at-rest encryption for secret material yet.
	MemoryClassPrivate MemoryClass = "private"
	MemoryClassSystem  MemoryClass = "system"
)

type MemoryConfigApplyOutcome added in v0.19.0 

type MemoryConfigApplyOutcome string

#1334 — what applying a template did (or, on a dry run, would do) for one role. 

const (
	// The memory had no rule for the role; the template's was copied in (locked if the template is required).
	MemoryConfigApplyOutcomeApplied MemoryConfigApplyOutcome = "APPLIED"
	// The memory's rule for the role was overwritten by a required template's, and is now locked.
	MemoryConfigApplyOutcomeReplaced MemoryConfigApplyOutcome = "REPLACED"
	// The memory already had a rule for the role, and a non-required template never overrides one.
	MemoryConfigApplyOutcomeSkippedConflict MemoryConfigApplyOutcome = "SKIPPED_CONFLICT"
	// A required template met a LOCKED rule that you have no authority to move; the rule stands.
	MemoryConfigApplyOutcomeSkippedLocked MemoryConfigApplyOutcome = "SKIPPED_LOCKED"
)

type MemoryConfigMemoryConfig added in v0.18.0 

type MemoryConfigMemoryConfig struct {
	// Null until the first rule is written.
	Id        *string `json:"id"`
	MemoryId  string  `json:"memoryId"`
	CreatedAt *string `json:"createdAt"`
	CreatedBy *string `json:"createdBy"`
	UpdatedAt *string `json:"updatedAt"`
	UpdatedBy *string `json:"updatedBy"`
	// Role-ascending.
	Rules []*MemoryConfigMemoryConfigRulesNodeRoleRule `json:"rules"`
}

MemoryConfigMemoryConfig includes the requested fields of the GraphQL type MemoryConfig. The GraphQL type's documentation follows.

#1325 — a memory's config: exactly one per memory, holding its node-role rules (one per role or declared sub-role). Read and changed only by the memory's managers. Materialized by the first rule write; before that it reads as empty, with a null id.

func (*MemoryConfigMemoryConfig) GetCreatedAt added in v0.18.0 

func (v *MemoryConfigMemoryConfig) GetCreatedAt() *string

GetCreatedAt returns MemoryConfigMemoryConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfig) GetCreatedBy added in v0.18.0 

func (v *MemoryConfigMemoryConfig) GetCreatedBy() *string

GetCreatedBy returns MemoryConfigMemoryConfig.CreatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfig) GetId added in v0.18.0 

func (v *MemoryConfigMemoryConfig) GetId() *string

GetId returns MemoryConfigMemoryConfig.Id, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfig) GetMemoryId added in v0.18.0 

func (v *MemoryConfigMemoryConfig) GetMemoryId() string

GetMemoryId returns MemoryConfigMemoryConfig.MemoryId, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfig) GetRules added in v0.18.0 

func (v *MemoryConfigMemoryConfig) GetRules() []*MemoryConfigMemoryConfigRulesNodeRoleRule

GetRules returns MemoryConfigMemoryConfig.Rules, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfig) GetUpdatedAt added in v0.18.0 

func (v *MemoryConfigMemoryConfig) GetUpdatedAt() *string

GetUpdatedAt returns MemoryConfigMemoryConfig.UpdatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfig) GetUpdatedBy added in v0.18.0 

func (v *MemoryConfigMemoryConfig) GetUpdatedBy() *string

GetUpdatedBy returns MemoryConfigMemoryConfig.UpdatedBy, and is useful for accessing the field via an interface.

type MemoryConfigMemoryConfigRulesNodeRoleRule added in v0.18.0 

type MemoryConfigMemoryConfigRulesNodeRoleRule struct {
	NodeRoleRuleFields `json:"-"`
}

MemoryConfigMemoryConfigRulesNodeRoleRule includes the requested fields of the GraphQL type NodeRoleRule. The GraphQL type's documentation follows.

#1325 — one node-role rule. Task and description references are stored by node id (they survive moves) and returned as a URN and an id, each with its state. Both are given only when the state is OK; see NodeRoleRuleRefState.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetAuthorTask added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetAuthorTask() *string

GetAuthorTask returns MemoryConfigMemoryConfigRulesNodeRoleRule.AuthorTask, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetAuthorTaskId added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetAuthorTaskId() *string

GetAuthorTaskId returns MemoryConfigMemoryConfigRulesNodeRoleRule.AuthorTaskId, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetAuthorTaskState added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns MemoryConfigMemoryConfigRulesNodeRoleRule.AuthorTaskState, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetCreatedAt added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetCreatedAt() string

GetCreatedAt returns MemoryConfigMemoryConfigRulesNodeRoleRule.CreatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetCreatedBy added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetCreatedBy() *string

GetCreatedBy returns MemoryConfigMemoryConfigRulesNodeRoleRule.CreatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetDescriptionNode added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetDescriptionNode() *string

GetDescriptionNode returns MemoryConfigMemoryConfigRulesNodeRoleRule.DescriptionNode, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetDescriptionNodeId added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetDescriptionNodeId() *string

GetDescriptionNodeId returns MemoryConfigMemoryConfigRulesNodeRoleRule.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetDescriptionNodeState added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns MemoryConfigMemoryConfigRulesNodeRoleRule.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetEnabled added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetEnabled() bool

GetEnabled returns MemoryConfigMemoryConfigRulesNodeRoleRule.Enabled, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetId added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetId() string

GetId returns MemoryConfigMemoryConfigRulesNodeRoleRule.Id, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetLocked added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetLocked() bool

GetLocked returns MemoryConfigMemoryConfigRulesNodeRoleRule.Locked, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetRevision added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetRevision() int

GetRevision returns MemoryConfigMemoryConfigRulesNodeRoleRule.Revision, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetRole added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetRole() string

GetRole returns MemoryConfigMemoryConfigRulesNodeRoleRule.Role, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetSourceTemplate added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetSourceTemplate() *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate

GetSourceTemplate returns MemoryConfigMemoryConfigRulesNodeRoleRule.SourceTemplate, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetSourceTemplateId added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetSourceTemplateId() *string

GetSourceTemplateId returns MemoryConfigMemoryConfigRulesNodeRoleRule.SourceTemplateId, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetStrictSubRoles added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetStrictSubRoles() bool

GetStrictSubRoles returns MemoryConfigMemoryConfigRulesNodeRoleRule.StrictSubRoles, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetUpdatedAt added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetUpdatedAt() *string

GetUpdatedAt returns MemoryConfigMemoryConfigRulesNodeRoleRule.UpdatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetUpdatedBy added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetUpdatedBy() *string

GetUpdatedBy returns MemoryConfigMemoryConfigRulesNodeRoleRule.UpdatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidateBy added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidateBy() *ContentValidator

GetValidateBy returns MemoryConfigMemoryConfigRulesNodeRoleRule.ValidateBy, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidationTask added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidationTask() *string

GetValidationTask returns MemoryConfigMemoryConfigRulesNodeRoleRule.ValidationTask, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidationTaskId added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidationTaskId() *string

GetValidationTaskId returns MemoryConfigMemoryConfigRulesNodeRoleRule.ValidationTaskId, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidationTaskState added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns MemoryConfigMemoryConfigRulesNodeRoleRule.ValidationTaskState, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) GetWriters added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) GetWriters() NodeRoleWriters

GetWriters returns MemoryConfigMemoryConfigRulesNodeRoleRule.Writers, and is useful for accessing the field via an interface.

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) MarshalJSON added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) MarshalJSON() ([]byte, error)

func (*MemoryConfigMemoryConfigRulesNodeRoleRule) UnmarshalJSON added in v0.18.0 

func (v *MemoryConfigMemoryConfigRulesNodeRoleRule) UnmarshalJSON(b []byte) error

type MemoryConfigResponse added in v0.18.0 

type MemoryConfigResponse struct {
	// #1325 — a memory's config, for the memory's managers only. For anyone else,
	// and for a missing memory, the same MEMORY_NOT_FOUND.
	MemoryConfig *MemoryConfigMemoryConfig `json:"memoryConfig"`
}

MemoryConfigResponse is returned by MemoryConfig on success.

func MemoryConfig added in v0.18.0 

func MemoryConfig(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
) (data_ *MemoryConfigResponse, err_ error)

func (*MemoryConfigResponse) GetMemoryConfig added in v0.18.0 

func (v *MemoryConfigResponse) GetMemoryConfig() *MemoryConfigMemoryConfig

GetMemoryConfig returns MemoryConfigResponse.MemoryConfig, and is useful for accessing the field via an interface.

type MemoryConfigTemplateFields added in v0.18.0 

type MemoryConfigTemplateFields struct {
	Id string `json:"id"`
	// Unique per owner among live templates; 1-64 lower-case letters, digits, '-' or '_'.
	Name        string                        `json:"name"`
	Description *string                       `json:"description"`
	OwnerType   MemoryConfigTemplateOwnerType `json:"ownerType"`
	// ID of the owning organization, user or App; null for the server.
	OwnerId *string `json:"ownerId"`
	// Applied as locked rules (#1334).
	Required bool `json:"required"`
	// Optimistic-concurrency token for the template AND its rules.
	Revision  int     `json:"revision"`
	CreatedAt string  `json:"createdAt"`
	CreatedBy *string `json:"createdBy"`
	UpdatedAt *string `json:"updatedAt"`
	UpdatedBy *string `json:"updatedBy"`
	// Role-ascending.
	Rules []*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule `json:"rules"`
}

MemoryConfigTemplateFields includes the GraphQL fields of MemoryConfigTemplate requested by the fragment MemoryConfigTemplateFields. The GraphQL type's documentation follows.

#1325 part (c) — a reusable rulebook with exactly one owner, COPIED into a memory's config when applied (never live-linked). Read and managed only by its owner's managers: a platform admin (server), an org ADMIN/OWNER (organization), the user themselves (user), the App's owner or org ADMIN/OWNER (App). For anyone else it does not exist.

func (*MemoryConfigTemplateFields) GetCreatedAt added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetCreatedAt() string

GetCreatedAt returns MemoryConfigTemplateFields.CreatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetCreatedBy added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetCreatedBy() *string

GetCreatedBy returns MemoryConfigTemplateFields.CreatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetDescription added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetDescription() *string

GetDescription returns MemoryConfigTemplateFields.Description, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetId added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetId() string

GetId returns MemoryConfigTemplateFields.Id, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetName added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetName() string

GetName returns MemoryConfigTemplateFields.Name, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetOwnerId added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetOwnerId() *string

GetOwnerId returns MemoryConfigTemplateFields.OwnerId, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetOwnerType added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetOwnerType() MemoryConfigTemplateOwnerType

GetOwnerType returns MemoryConfigTemplateFields.OwnerType, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetRequired added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetRequired() bool

GetRequired returns MemoryConfigTemplateFields.Required, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetRevision added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetRevision() int

GetRevision returns MemoryConfigTemplateFields.Revision, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetRules added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetRules() []*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule

GetRules returns MemoryConfigTemplateFields.Rules, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetUpdatedAt added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetUpdatedAt() *string

GetUpdatedAt returns MemoryConfigTemplateFields.UpdatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFields) GetUpdatedBy added in v0.18.0 

func (v *MemoryConfigTemplateFields) GetUpdatedBy() *string

GetUpdatedBy returns MemoryConfigTemplateFields.UpdatedBy, and is useful for accessing the field via an interface.

type MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule added in v0.18.0 

type MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule struct {
	Role                string               `json:"role"`
	Enabled             bool                 `json:"enabled"`
	StrictSubRoles      bool                 `json:"strictSubRoles"`
	Writers             NodeRoleWriters      `json:"writers"`
	ValidateBy          *ContentValidator    `json:"validateBy"`
	AuthorTask          *string              `json:"authorTask"`
	AuthorTaskId        *string              `json:"authorTaskId"`
	AuthorTaskState     NodeRoleRuleRefState `json:"authorTaskState"`
	ValidationTask      *string              `json:"validationTask"`
	ValidationTaskId    *string              `json:"validationTaskId"`
	ValidationTaskState NodeRoleRuleRefState `json:"validationTaskState"`
	// Documentation, not procedure: a deleted description node reads as NONE, never BROKEN.
	DescriptionNode      *string              `json:"descriptionNode"`
	DescriptionNodeId    *string              `json:"descriptionNodeId"`
	DescriptionNodeState NodeRoleRuleRefState `json:"descriptionNodeState"`
}

MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule includes the requested fields of the GraphQL type MemoryConfigTemplateRule. The GraphQL type's documentation follows.

#1325 part (c) — one rule of a template: a node-role rule without the config-only fields.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetAuthorTask added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetAuthorTask() *string

GetAuthorTask returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.AuthorTask, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetAuthorTaskId added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetAuthorTaskId() *string

GetAuthorTaskId returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.AuthorTaskId, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetAuthorTaskState added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.AuthorTaskState, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetDescriptionNode added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetDescriptionNode() *string

GetDescriptionNode returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.DescriptionNode, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetDescriptionNodeId added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetDescriptionNodeId() *string

GetDescriptionNodeId returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetDescriptionNodeState added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetEnabled added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetEnabled() bool

GetEnabled returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.Enabled, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetRole added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetRole() string

GetRole returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.Role, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetStrictSubRoles added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetStrictSubRoles() bool

GetStrictSubRoles returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.StrictSubRoles, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidateBy added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidateBy() *ContentValidator

GetValidateBy returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.ValidateBy, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidationTask added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidationTask() *string

GetValidationTask returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.ValidationTask, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidationTaskId added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidationTaskId() *string

GetValidationTaskId returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.ValidationTaskId, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidationTaskState added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.ValidationTaskState, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetWriters added in v0.18.0 

func (v *MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule) GetWriters() NodeRoleWriters

GetWriters returns MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule.Writers, and is useful for accessing the field via an interface.

type MemoryConfigTemplateFilter added in v0.18.0 

type MemoryConfigTemplateFilter struct {
	// ID or URN of the owner (with ownerType). An owner you do not manage matches nothing.
	OwnerRef  *string                        `json:"ownerRef,omitempty"`
	OwnerType *MemoryConfigTemplateOwnerType `json:"ownerType,omitempty"`
}

Filter for memoryConfigTemplates(). Narrows the templates you manage; it never widens them.

func (*MemoryConfigTemplateFilter) GetOwnerRef added in v0.18.0 

func (v *MemoryConfigTemplateFilter) GetOwnerRef() *string

GetOwnerRef returns MemoryConfigTemplateFilter.OwnerRef, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateFilter) GetOwnerType added in v0.18.0 

func (v *MemoryConfigTemplateFilter) GetOwnerType() *MemoryConfigTemplateOwnerType

GetOwnerType returns MemoryConfigTemplateFilter.OwnerType, and is useful for accessing the field via an interface.

type MemoryConfigTemplateMemoryConfigTemplate added in v0.18.0 

type MemoryConfigTemplateMemoryConfigTemplate struct {
	MemoryConfigTemplateFields `json:"-"`
}

MemoryConfigTemplateMemoryConfigTemplate includes the requested fields of the GraphQL type MemoryConfigTemplate. The GraphQL type's documentation follows.

#1325 part (c) — a reusable rulebook with exactly one owner, COPIED into a memory's config when applied (never live-linked). Read and managed only by its owner's managers: a platform admin (server), an org ADMIN/OWNER (organization), the user themselves (user), the App's owner or org ADMIN/OWNER (App). For anyone else it does not exist.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetCreatedAt added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetCreatedAt() string

GetCreatedAt returns MemoryConfigTemplateMemoryConfigTemplate.CreatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetCreatedBy added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetCreatedBy() *string

GetCreatedBy returns MemoryConfigTemplateMemoryConfigTemplate.CreatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetDescription added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetDescription() *string

GetDescription returns MemoryConfigTemplateMemoryConfigTemplate.Description, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetId added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetId() string

GetId returns MemoryConfigTemplateMemoryConfigTemplate.Id, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetName added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetName() string

GetName returns MemoryConfigTemplateMemoryConfigTemplate.Name, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetOwnerId added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetOwnerId() *string

GetOwnerId returns MemoryConfigTemplateMemoryConfigTemplate.OwnerId, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetOwnerType added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetOwnerType() MemoryConfigTemplateOwnerType

GetOwnerType returns MemoryConfigTemplateMemoryConfigTemplate.OwnerType, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetRequired added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetRequired() bool

GetRequired returns MemoryConfigTemplateMemoryConfigTemplate.Required, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetRevision added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetRevision() int

GetRevision returns MemoryConfigTemplateMemoryConfigTemplate.Revision, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetRules added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetRules() []*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule

GetRules returns MemoryConfigTemplateMemoryConfigTemplate.Rules, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetUpdatedAt added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetUpdatedAt() *string

GetUpdatedAt returns MemoryConfigTemplateMemoryConfigTemplate.UpdatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) GetUpdatedBy added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) GetUpdatedBy() *string

GetUpdatedBy returns MemoryConfigTemplateMemoryConfigTemplate.UpdatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplateMemoryConfigTemplate) MarshalJSON added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) MarshalJSON() ([]byte, error)

func (*MemoryConfigTemplateMemoryConfigTemplate) UnmarshalJSON added in v0.18.0 

func (v *MemoryConfigTemplateMemoryConfigTemplate) UnmarshalJSON(b []byte) error

type MemoryConfigTemplateOwnerType added in v0.18.0 

type MemoryConfigTemplateOwnerType string

#1325 part (c) — which entity owns a MemoryConfigTemplate. Exactly one per template. 

const (
	MemoryConfigTemplateOwnerTypeApp          MemoryConfigTemplateOwnerType = "APP"
	MemoryConfigTemplateOwnerTypeHadronServer MemoryConfigTemplateOwnerType = "HADRON_SERVER"
	MemoryConfigTemplateOwnerTypeOrganization MemoryConfigTemplateOwnerType = "ORGANIZATION"
	MemoryConfigTemplateOwnerTypeUser         MemoryConfigTemplateOwnerType = "USER"
)

type MemoryConfigTemplateResponse added in v0.18.0 

type MemoryConfigTemplateResponse struct {
	// #1325 part (c) — one template you manage, by id; null for anything else, including a missing or deleted one.
	MemoryConfigTemplate *MemoryConfigTemplateMemoryConfigTemplate `json:"memoryConfigTemplate"`
}

MemoryConfigTemplateResponse is returned by MemoryConfigTemplate on success.

func MemoryConfigTemplate added in v0.18.0 

func MemoryConfigTemplate(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *MemoryConfigTemplateResponse, err_ error)

func (*MemoryConfigTemplateResponse) GetMemoryConfigTemplate added in v0.18.0 

func (v *MemoryConfigTemplateResponse) GetMemoryConfigTemplate() *MemoryConfigTemplateMemoryConfigTemplate

GetMemoryConfigTemplate returns MemoryConfigTemplateResponse.MemoryConfigTemplate, and is useful for accessing the field via an interface.

type MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage added in v0.18.0 

type MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage struct {
	Total int                                                                                             `json:"total"`
	Items []*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate `json:"items"`
}

MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage includes the requested fields of the GraphQL type MemoryConfigTemplatesPage.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage) GetItems added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage) GetItems() []*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate

GetItems returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage.Items, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage) GetTotal added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage) GetTotal() int

GetTotal returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage.Total, and is useful for accessing the field via an interface.

type MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate added in v0.18.0 

type MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate struct {
	MemoryConfigTemplateFields `json:"-"`
}

MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate includes the requested fields of the GraphQL type MemoryConfigTemplate. The GraphQL type's documentation follows.

#1325 part (c) — a reusable rulebook with exactly one owner, COPIED into a memory's config when applied (never live-linked). Read and managed only by its owner's managers: a platform admin (server), an org ADMIN/OWNER (organization), the user themselves (user), the App's owner or org ADMIN/OWNER (App). For anyone else it does not exist.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetCreatedAt added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetCreatedAt() string

GetCreatedAt returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.CreatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetCreatedBy added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetCreatedBy() *string

GetCreatedBy returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.CreatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetDescription added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetDescription() *string

GetDescription returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.Description, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetId added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetId() string

GetId returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.Id, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetName added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetName() string

GetName returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.Name, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetOwnerId added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetOwnerId() *string

GetOwnerId returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.OwnerId, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetOwnerType added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetOwnerType() MemoryConfigTemplateOwnerType

GetOwnerType returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.OwnerType, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetRequired added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetRequired() bool

GetRequired returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.Required, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetRevision added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetRevision() int

GetRevision returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.Revision, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetRules added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetRules() []*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule

GetRules returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.Rules, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetUpdatedAt added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetUpdatedAt() *string

GetUpdatedAt returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.UpdatedAt, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetUpdatedBy added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) GetUpdatedBy() *string

GetUpdatedBy returns MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate.UpdatedBy, and is useful for accessing the field via an interface.

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) MarshalJSON added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) MarshalJSON() ([]byte, error)

func (*MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) UnmarshalJSON added in v0.18.0 

func (v *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPageItemsMemoryConfigTemplate) UnmarshalJSON(b []byte) error

type MemoryConfigTemplatesResponse added in v0.18.0 

type MemoryConfigTemplatesResponse struct {
	// #1325 part (c) — the templates you manage, name-ascending. Default page 50,
	// at most 200; limit 0 returns the count only.
	MemoryConfigTemplates *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage `json:"memoryConfigTemplates"`
}

MemoryConfigTemplatesResponse is returned by MemoryConfigTemplates on success.

func MemoryConfigTemplates added in v0.18.0 

func MemoryConfigTemplates(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *MemoryConfigTemplateFilter,
	limit *int,
	offset *int,
) (data_ *MemoryConfigTemplatesResponse, err_ error)

Paged: default 50, cap 200 (cor:api:120). The CLI pages to exhaustion.

func (*MemoryConfigTemplatesResponse) GetMemoryConfigTemplates added in v0.18.0 

func (v *MemoryConfigTemplatesResponse) GetMemoryConfigTemplates() *MemoryConfigTemplatesMemoryConfigTemplatesMemoryConfigTemplatesPage

GetMemoryConfigTemplates returns MemoryConfigTemplatesResponse.MemoryConfigTemplates, and is useful for accessing the field via an interface.

type MemoryConfigWarningFields added in v0.18.0 

type MemoryConfigWarningFields struct {
	Code      string                `json:"code"`
	Role      string                `json:"role"`
	Field     *string               `json:"field"`
	TaskUrn   *string               `json:"taskUrn"`
	TaskState *NodeRoleRuleRefState `json:"taskState"`
}

MemoryConfigWarningFields includes the GraphQL fields of MemoryConfigWarning requested by the fragment MemoryConfigWarningFields. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*MemoryConfigWarningFields) GetCode added in v0.18.0 

func (v *MemoryConfigWarningFields) GetCode() string

GetCode returns MemoryConfigWarningFields.Code, and is useful for accessing the field via an interface.

func (*MemoryConfigWarningFields) GetField added in v0.18.0 

func (v *MemoryConfigWarningFields) GetField() *string

GetField returns MemoryConfigWarningFields.Field, and is useful for accessing the field via an interface.

func (*MemoryConfigWarningFields) GetRole added in v0.18.0 

func (v *MemoryConfigWarningFields) GetRole() string

GetRole returns MemoryConfigWarningFields.Role, and is useful for accessing the field via an interface.

func (*MemoryConfigWarningFields) GetTaskState added in v0.18.0 

func (v *MemoryConfigWarningFields) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns MemoryConfigWarningFields.TaskState, and is useful for accessing the field via an interface.

func (*MemoryConfigWarningFields) GetTaskUrn added in v0.18.0 

func (v *MemoryConfigWarningFields) GetTaskUrn() *string

GetTaskUrn returns MemoryConfigWarningFields.TaskUrn, and is useful for accessing the field via an interface.

type MemoryFilter added in v0.5.1 

type MemoryFilter struct {
	// Restrict to exactly these classes. Omitted, the noisy agent system class is hidden by default; pass it explicitly to surface system memories.
	MemoryClasses []MemoryClass `json:"memoryClasses,omitempty"`
	// #1179 — true restricts the list to the caller's OWN ORG-LESS memories:
	// organizationId IS NULL AND the caller owns it. For ALL callers INCLUDING
	// platform ADMIN/OWNER (owner scope is never an admin-bypass surface), the
	// same intent as AgentFilter.ownedByMe and AppFilter.ownedByMe. Org-less by
	// definition, so orgId is not consulted. App-key callers (no user context)
	// and impersonated sessions get an empty page. Powers the portal's
	// "My memories".
	//
	// "Owns it" is PER CLASS, because Memory has two independent owner columns
	// and the read gates already split on exactly this line (canReadMemoryRecord
	// and the MCP canReadMemory both branch on personal/private FIRST and admit
	// userId there, falling through to ownerUserId for every other class):
	//
	// - personal / private → userId, the STRICT owner;
	// - every other class  → ownerUserId, the spec-047 user TENANT owner.
	//
	// This is where the memory filter is NECESSARILY wider than its Agent and
	// App siblings, which have one owner column each and can say ownerUserId
	// alone. Keying memories on ownerUserId alone would hand a personal memory
	// to its tenant owner when the two columns differ — legal rows, since
	// nothing constrains them to agree — while memory(ref:) refuses that same
	// caller. Keying on the class pair alone was the ORIGINAL defect: it was
	// only ever a proxy for ownership, correct while the two coincided (#1176).
	//
	// So a knowledge-class memory under a user root
	// (hrn:mem:holger:holgers-gear) is in this slice, and an ORG-owned personal
	// memory is not (it has an organizationId) — which matches what the
	// portal's class-plus-client-side-repair query already returned.
	//
	// Composes by AND like every other clause, so it only ever narrows:
	// combined with visibility PUBLIC it is empty by construction (#758
	// excludes user-owned rows from the marketplace slice), and combined with
	// sharedWithMe it narrows that slice rather than replacing it.
	OwnedByMe *bool `json:"ownedByMe,omitempty"`
	// true selects the distinct set of memories shared WITH the caller
	// via MemoryShare (the caller is a grantee) — the portal's
	// Memories-shared-with-me tab. This is its own slice, NOT part of the
	// caller's owned/org union: a grantee is never their own grantor, so
	// it excludes owned memories. App-key callers get an empty page
	// (sharing is a user-to-user concept). See Memory.myShare for the
	// per-row grantor + role.
	SharedWithMe *bool `json:"sharedWithMe,omitempty"`
	// Restrict by visibility. PUBLIC selects the marketplace slice (see above).
	Visibility *MemoryVisibility `json:"visibility,omitempty"`
}

Filter for the uniform memories() list (#473). All clauses AND-combine and only ever narrow the caller's accessible scope — with two documented slice SELECTIONS, each switching which readable set the list draws from (never widening access beyond what the caller may already read): - visibility: PUBLIC switches from the caller's own union (org-owned + org-subscribed + own user-owned) to the public marketplace slice (every PUBLIC memory — the old publicMemories query). - sharedWithMe: true switches to the memories shared WITH the caller via MemoryShare (the caller is a grantee) — the portal's Memories-shared-with-me tab.

func (*MemoryFilter) GetMemoryClasses added in v0.5.1 

func (v *MemoryFilter) GetMemoryClasses() []MemoryClass

GetMemoryClasses returns MemoryFilter.MemoryClasses, and is useful for accessing the field via an interface.

func (*MemoryFilter) GetOwnedByMe added in v0.15.0 

func (v *MemoryFilter) GetOwnedByMe() *bool

GetOwnedByMe returns MemoryFilter.OwnedByMe, and is useful for accessing the field via an interface.

func (*MemoryFilter) GetSharedWithMe added in v0.9.0 

func (v *MemoryFilter) GetSharedWithMe() *bool

GetSharedWithMe returns MemoryFilter.SharedWithMe, and is useful for accessing the field via an interface.

func (*MemoryFilter) GetVisibility added in v0.5.1 

func (v *MemoryFilter) GetVisibility() *MemoryVisibility

GetVisibility returns MemoryFilter.Visibility, and is useful for accessing the field via an interface.

type MemoryMemberRole added in v0.3.0 

type MemoryMemberRole string

023-app-shape US4: role on a MemoryMember row. Symmetric team membership for group-class memory. - reader: read access. - writer: read + write (the member can add/edit/delete nodes within the memory). - owner: read + write + management — add/remove other members, change roles, delete the Memory itself. Subject to the last-owner protection rule (FR-038): the platform refuses to remove or demote the sole remaining owner; the path to fully empty a group memory is to delete it. 

const (
	MemoryMemberRoleOwner  MemoryMemberRole = "owner"
	MemoryMemberRoleReader MemoryMemberRole = "reader"
	MemoryMemberRoleWriter MemoryMemberRole = "writer"
)

type MemoryMembersMemory added in v0.3.0 

type MemoryMembersMemory struct {
	Id string `json:"id"`
	// 023-app-shape US4: team membership rows on this memory. Non-empty
	// only when class = group (FR-027). Visible to any current member
	// (any role) and to ADMIN/OWNER of the memory's owning org.
	Members []*MemoryMembersMemoryMembersMemoryMember `json:"members"`
}

MemoryMembersMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*MemoryMembersMemory) GetId added in v0.3.0 

func (v *MemoryMembersMemory) GetId() string

GetId returns MemoryMembersMemory.Id, and is useful for accessing the field via an interface.

func (*MemoryMembersMemory) GetMembers added in v0.3.0 

func (v *MemoryMembersMemory) GetMembers() []*MemoryMembersMemoryMembersMemoryMember

GetMembers returns MemoryMembersMemory.Members, and is useful for accessing the field via an interface.

type MemoryMembersMemoryMembersMemoryMember added in v0.3.0 

type MemoryMembersMemoryMembersMemoryMember struct {
	Role      MemoryMemberRole                            `json:"role"`
	CreatedAt string                                      `json:"createdAt"`
	User      *MemoryMembersMemoryMembersMemoryMemberUser `json:"user"`
}

MemoryMembersMemoryMembersMemoryMember includes the requested fields of the GraphQL type MemoryMember. The GraphQL type's documentation follows.

023-app-shape US4: symmetric team-membership row for group-class memory. The "Company Brain" model — multiple users collaboratively read/write a shared memory, governance by role, no single owner on the Memory itself.

func (*MemoryMembersMemoryMembersMemoryMember) GetCreatedAt added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMember) GetCreatedAt() string

GetCreatedAt returns MemoryMembersMemoryMembersMemoryMember.CreatedAt, and is useful for accessing the field via an interface.

func (*MemoryMembersMemoryMembersMemoryMember) GetRole added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMember) GetRole() MemoryMemberRole

GetRole returns MemoryMembersMemoryMembersMemoryMember.Role, and is useful for accessing the field via an interface.

func (*MemoryMembersMemoryMembersMemoryMember) GetUser added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMember) GetUser() *MemoryMembersMemoryMembersMemoryMemberUser

GetUser returns MemoryMembersMemoryMembersMemoryMember.User, and is useful for accessing the field via an interface.

type MemoryMembersMemoryMembersMemoryMemberUser added in v0.3.0 

type MemoryMembersMemoryMembersMemoryMemberUser struct {
	MemUserFields `json:"-"`
}

MemoryMembersMemoryMembersMemoryMemberUser includes the requested fields of the GraphQL type User.

func (*MemoryMembersMemoryMembersMemoryMemberUser) GetEmail added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMemberUser) GetEmail() *string

GetEmail returns MemoryMembersMemoryMembersMemoryMemberUser.Email, and is useful for accessing the field via an interface.

func (*MemoryMembersMemoryMembersMemoryMemberUser) GetHandle added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMemberUser) GetHandle() *string

GetHandle returns MemoryMembersMemoryMembersMemoryMemberUser.Handle, and is useful for accessing the field via an interface.

func (*MemoryMembersMemoryMembersMemoryMemberUser) GetId added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMemberUser) GetId() string

GetId returns MemoryMembersMemoryMembersMemoryMemberUser.Id, and is useful for accessing the field via an interface.

func (*MemoryMembersMemoryMembersMemoryMemberUser) GetName added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMemberUser) GetName() *string

GetName returns MemoryMembersMemoryMembersMemoryMemberUser.Name, and is useful for accessing the field via an interface.

func (*MemoryMembersMemoryMembersMemoryMemberUser) MarshalJSON added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMemberUser) MarshalJSON() ([]byte, error)

func (*MemoryMembersMemoryMembersMemoryMemberUser) UnmarshalJSON added in v0.3.0 

func (v *MemoryMembersMemoryMembersMemoryMemberUser) UnmarshalJSON(b []byte) error

type MemoryMembersResponse added in v0.3.0 

type MemoryMembersResponse struct {
	// Fetch a single Memory (org member, shared-read gate, or platform ADMIN).
	// Missing and unreadable refs both return null without an error, so a caller
	// cannot use this field to test whether a private memory exists. Malformed
	// refs still fail as caller errors, and operational faults still propagate.
	//
	// 'ref' accepts the entity's ID or URN.
	Memory *MemoryMembersMemory `json:"memory"`
}

MemoryMembersResponse is returned by MemoryMembers on success.

func MemoryMembers added in v0.3.0 

func MemoryMembers(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *MemoryMembersResponse, err_ error)

memory(ref) — PK id or URN (hadron-server#473) — is the path to a memory's member/share rows.

func (*MemoryMembersResponse) GetMemory added in v0.3.0 

func (v *MemoryMembersResponse) GetMemory() *MemoryMembersMemory

GetMemory returns MemoryMembersResponse.Memory, and is useful for accessing the field via an interface.

type MemoryShareRole added in v0.3.0 

type MemoryShareRole string

023-app-shape US3: role on a MemoryShare row. Asymmetric grant for personal-class memory. - reader: read access only. - writer: read + write (the grantee can add/edit/delete nodes within the memory). 

const (
	MemoryShareRoleReader MemoryShareRole = "reader"
	MemoryShareRoleWriter MemoryShareRole = "writer"
)

type MemorySharesMemory added in v0.3.0 

type MemorySharesMemory struct {
	Id string `json:"id"`
	// 023-app-shape US3: cross-user grants on this memory. Non-empty
	// only when class = personal (FR-018). Includes grantee + role for
	// each row. Visible only to the principal (memory.userId) and to
	// ADMIN/OWNER of the memory's owning org.
	Shares []*MemorySharesMemorySharesMemoryShare `json:"shares"`
}

MemorySharesMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*MemorySharesMemory) GetId added in v0.3.0 

func (v *MemorySharesMemory) GetId() string

GetId returns MemorySharesMemory.Id, and is useful for accessing the field via an interface.

func (*MemorySharesMemory) GetShares added in v0.3.0 

func (v *MemorySharesMemory) GetShares() []*MemorySharesMemorySharesMemoryShare

GetShares returns MemorySharesMemory.Shares, and is useful for accessing the field via an interface.

type MemorySharesMemorySharesMemoryShare added in v0.3.0 

type MemorySharesMemorySharesMemoryShare struct {
	Role      MemoryShareRole `json:"role"`
	CreatedAt string          `json:"createdAt"`
	// The User who was granted access.
	Grantee *MemorySharesMemorySharesMemoryShareGranteeUser `json:"grantee"`
}

MemorySharesMemorySharesMemoryShare includes the requested fields of the GraphQL type MemoryShare. The GraphQL type's documentation follows.

023-app-shape US3: asymmetric cross-user grant on a personal-class Memory. The principal (memory.userId) grants a grantee read/write access. Used for per-pairing isolation patterns (e.g., Alice's personal Memory paired-with-Mentor-A is distinct from her paired-with-Mentor-B Memory, each with its own MemoryShare).

func (*MemorySharesMemorySharesMemoryShare) GetCreatedAt added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShare) GetCreatedAt() string

GetCreatedAt returns MemorySharesMemorySharesMemoryShare.CreatedAt, and is useful for accessing the field via an interface.

func (*MemorySharesMemorySharesMemoryShare) GetGrantee added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShare) GetGrantee() *MemorySharesMemorySharesMemoryShareGranteeUser

GetGrantee returns MemorySharesMemorySharesMemoryShare.Grantee, and is useful for accessing the field via an interface.

func (*MemorySharesMemorySharesMemoryShare) GetRole added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShare) GetRole() MemoryShareRole

GetRole returns MemorySharesMemorySharesMemoryShare.Role, and is useful for accessing the field via an interface.

type MemorySharesMemorySharesMemoryShareGranteeUser added in v0.3.0 

type MemorySharesMemorySharesMemoryShareGranteeUser struct {
	MemUserFields `json:"-"`
}

MemorySharesMemorySharesMemoryShareGranteeUser includes the requested fields of the GraphQL type User.

func (*MemorySharesMemorySharesMemoryShareGranteeUser) GetEmail added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShareGranteeUser) GetEmail() *string

GetEmail returns MemorySharesMemorySharesMemoryShareGranteeUser.Email, and is useful for accessing the field via an interface.

func (*MemorySharesMemorySharesMemoryShareGranteeUser) GetHandle added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShareGranteeUser) GetHandle() *string

GetHandle returns MemorySharesMemorySharesMemoryShareGranteeUser.Handle, and is useful for accessing the field via an interface.

func (*MemorySharesMemorySharesMemoryShareGranteeUser) GetId added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShareGranteeUser) GetId() string

GetId returns MemorySharesMemorySharesMemoryShareGranteeUser.Id, and is useful for accessing the field via an interface.

func (*MemorySharesMemorySharesMemoryShareGranteeUser) GetName added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShareGranteeUser) GetName() *string

GetName returns MemorySharesMemorySharesMemoryShareGranteeUser.Name, and is useful for accessing the field via an interface.

func (*MemorySharesMemorySharesMemoryShareGranteeUser) MarshalJSON added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShareGranteeUser) MarshalJSON() ([]byte, error)

func (*MemorySharesMemorySharesMemoryShareGranteeUser) UnmarshalJSON added in v0.3.0 

func (v *MemorySharesMemorySharesMemoryShareGranteeUser) UnmarshalJSON(b []byte) error

type MemorySharesResponse added in v0.3.0 

type MemorySharesResponse struct {
	// Fetch a single Memory (org member, shared-read gate, or platform ADMIN).
	// Missing and unreadable refs both return null without an error, so a caller
	// cannot use this field to test whether a private memory exists. Malformed
	// refs still fail as caller errors, and operational faults still propagate.
	//
	// 'ref' accepts the entity's ID or URN.
	Memory *MemorySharesMemory `json:"memory"`
}

MemorySharesResponse is returned by MemoryShares on success.

func MemoryShares added in v0.3.0 

func MemoryShares(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *MemorySharesResponse, err_ error)

func (*MemorySharesResponse) GetMemory added in v0.3.0 

func (v *MemorySharesResponse) GetMemory() *MemorySharesMemory

GetMemory returns MemorySharesResponse.Memory, and is useful for accessing the field via an interface.

type MemorySubscriptionsMemory added in v0.7.0 

type MemorySubscriptionsMemory struct {
	Id            string                                                      `json:"id"`
	Subscriptions []*MemorySubscriptionsMemorySubscriptionsMemorySubscription `json:"subscriptions"`
}

MemorySubscriptionsMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*MemorySubscriptionsMemory) GetId added in v0.7.0 

func (v *MemorySubscriptionsMemory) GetId() string

GetId returns MemorySubscriptionsMemory.Id, and is useful for accessing the field via an interface.

func (*MemorySubscriptionsMemory) GetSubscriptions added in v0.7.0 

func (v *MemorySubscriptionsMemory) GetSubscriptions() []*MemorySubscriptionsMemorySubscriptionsMemorySubscription

GetSubscriptions returns MemorySubscriptionsMemory.Subscriptions, and is useful for accessing the field via an interface.

type MemorySubscriptionsMemorySubscriptionsMemorySubscription added in v0.7.0 

type MemorySubscriptionsMemorySubscriptionsMemorySubscription struct {
	Role      Role `json:"role"`
	Activated bool `json:"activated"`
	// The subscriber Organization when the caller may read it; memory access alone does not authorize it.
	Organization *MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization `json:"organization"`
}

MemorySubscriptionsMemorySubscriptionsMemorySubscription includes the requested fields of the GraphQL type MemorySubscription. The GraphQL type's documentation follows.

An organization's subscription to a memory it does not own.

func (*MemorySubscriptionsMemorySubscriptionsMemorySubscription) GetActivated added in v0.7.0 

func (v *MemorySubscriptionsMemorySubscriptionsMemorySubscription) GetActivated() bool

GetActivated returns MemorySubscriptionsMemorySubscriptionsMemorySubscription.Activated, and is useful for accessing the field via an interface.

func (*MemorySubscriptionsMemorySubscriptionsMemorySubscription) GetOrganization added in v0.7.0 

func (v *MemorySubscriptionsMemorySubscriptionsMemorySubscription) GetOrganization() *MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization

GetOrganization returns MemorySubscriptionsMemorySubscriptionsMemorySubscription.Organization, and is useful for accessing the field via an interface.

func (*MemorySubscriptionsMemorySubscriptionsMemorySubscription) GetRole added in v0.7.0 

func (v *MemorySubscriptionsMemorySubscriptionsMemorySubscription) GetRole() Role

GetRole returns MemorySubscriptionsMemorySubscriptionsMemorySubscription.Role, and is useful for accessing the field via an interface.

type MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization added in v0.7.0 

type MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization struct {
	Id   string `json:"id"`
	Name string `json:"name"`
	Urn  string `json:"urn"`
}

MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization) GetId added in v0.7.0 

func (v *MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization) GetId() string

GetId returns MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization.Id, and is useful for accessing the field via an interface.

func (*MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization) GetName added in v0.7.0 

func (v *MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization) GetName() string

GetName returns MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization.Name, and is useful for accessing the field via an interface.

func (*MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization) GetUrn added in v0.7.0 

func (v *MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization) GetUrn() string

GetUrn returns MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization.Urn, and is useful for accessing the field via an interface.

type MemorySubscriptionsResponse added in v0.7.0 

type MemorySubscriptionsResponse struct {
	// Fetch a single Memory (org member, shared-read gate, or platform ADMIN).
	// Missing and unreadable refs both return null without an error, so a caller
	// cannot use this field to test whether a private memory exists. Malformed
	// refs still fail as caller errors, and operational faults still propagate.
	//
	// 'ref' accepts the entity's ID or URN.
	Memory *MemorySubscriptionsMemory `json:"memory"`
}

MemorySubscriptionsResponse is returned by MemorySubscriptions on success.

func MemorySubscriptions added in v0.7.0 

func MemorySubscriptions(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *MemorySubscriptionsResponse, err_ error)

func (*MemorySubscriptionsResponse) GetMemory added in v0.7.0 

func (v *MemorySubscriptionsResponse) GetMemory() *MemorySubscriptionsMemory

GetMemory returns MemorySubscriptionsResponse.Memory, and is useful for accessing the field via an interface.

type MemoryTransferHandling added in v0.18.0 

type MemoryTransferHandling string
const (
	MemoryTransferHandlingCarry  MemoryTransferHandling = "CARRY"
	MemoryTransferHandlingCreate MemoryTransferHandling = "CREATE"
	MemoryTransferHandlingRefuse MemoryTransferHandling = "REFUSE"
	MemoryTransferHandlingRemove MemoryTransferHandling = "REMOVE"
)

type MemoryValidationCheck added in v0.9.0 

type MemoryValidationCheck string

One health check the validator runs (#819). 

const (
	// An edge whose target node is missing OR soft-deleted. A hard-deleted target cannot occur - Edge.target is FK-enforced with onDelete: Cascade - so in practice this means a dangling edge to a tombstone.
	MemoryValidationCheckBrokenRef MemoryValidationCheck = "BROKEN_REF"
	// embedding_failed_at is set - a retryable failure awaiting its backoff, or the permanent class (deterministic 4xx, dimension mismatch, #206 encrypted-no-plaintext) recoverable via retryFailedEmbeddings (spec 033 / #882). Such a node is absent from vector search, which from outside looks identical to no hits matching.
	MemoryValidationCheckEmbedFailed MemoryValidationCheck = "EMBED_FAILED"
	// objectType/properties violate the memory declared schema (#725).
	MemoryValidationCheckSchema MemoryValidationCheck = "SCHEMA"
	// A node with no description, content, or abstract.
	MemoryValidationCheckSparse MemoryValidationCheck = "SPARSE"
	// The abstract no longer reflects current content (spec 032 FR-011).
	MemoryValidationCheckStaleAbstract MemoryValidationCheck = "STALE_ABSTRACT"
)

type MemoryVisibility 

type MemoryVisibility string

035-visibility-enum-cleanup: meaningful only for knowledge (PUBLIC/ORGANIZATION) and group (GROUP); null otherwise. PERSONAL/PRIVATE were dropped — privacy is the personal/private memory CLASS now. 

const (
	// 023-app-shape US4: team-shared visibility. Bound bidirectionally
	// to MemoryClass.group by the chk_memory_group_visibility CHECK
	// constraint — a memory has class=group iff visibility=GROUP.
	MemoryVisibilityGroup        MemoryVisibility = "GROUP"
	MemoryVisibilityOrganization MemoryVisibility = "ORGANIZATION"
	MemoryVisibilityPublic       MemoryVisibility = "PUBLIC"
)

type MergeNodesInput added in v0.7.0 

type MergeNodesInput struct {
	// Hard-delete the source node after a successful merge.
	DeleteSource *bool `json:"deleteSource,omitempty"`
	// Fields to merge. Omit (or null) to merge every mergeable field.
	Include []NodeMergeField `json:"include,omitempty"`
	// Source node — ID or fully-qualified URN. Folded into 'target'.
	Source string `json:"source"`
	// Target node — ID or fully-qualified URN. The surviving node.
	Target string `json:"target"`
}

func (*MergeNodesInput) GetDeleteSource added in v0.7.0 

func (v *MergeNodesInput) GetDeleteSource() *bool

GetDeleteSource returns MergeNodesInput.DeleteSource, and is useful for accessing the field via an interface.

func (*MergeNodesInput) GetInclude added in v0.7.0 

func (v *MergeNodesInput) GetInclude() []NodeMergeField

GetInclude returns MergeNodesInput.Include, and is useful for accessing the field via an interface.

func (*MergeNodesInput) GetSource added in v0.7.0 

func (v *MergeNodesInput) GetSource() string

GetSource returns MergeNodesInput.Source, and is useful for accessing the field via an interface.

func (*MergeNodesInput) GetTarget added in v0.7.0 

func (v *MergeNodesInput) GetTarget() string

GetTarget returns MergeNodesInput.Target, and is useful for accessing the field via an interface.

type MergeNodesMergeNodesNode added in v0.7.0 

type MergeNodesMergeNodesNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string `json:"nodeType"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role *string  `json:"role"`
	Tags []string `json:"tags"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool  `json:"isRunnable"`
	UpdatedAt  string `json:"updatedAt"`
}

MergeNodesMergeNodesNode includes the requested fields of the GraphQL type Node.

func (*MergeNodesMergeNodesNode) GetId added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetId() string

GetId returns MergeNodesMergeNodesNode.Id, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetIsRunnable added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetIsRunnable() *bool

GetIsRunnable returns MergeNodesMergeNodesNode.IsRunnable, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetLoc added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetLoc() string

GetLoc returns MergeNodesMergeNodesNode.Loc, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetMemoryId added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetMemoryId() string

GetMemoryId returns MergeNodesMergeNodesNode.MemoryId, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetName added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetName() string

GetName returns MergeNodesMergeNodesNode.Name, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetNodeType added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetNodeType() string

GetNodeType returns MergeNodesMergeNodesNode.NodeType, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetRole added in v0.15.0 

func (v *MergeNodesMergeNodesNode) GetRole() *string

GetRole returns MergeNodesMergeNodesNode.Role, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetTags added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetTags() []string

GetTags returns MergeNodesMergeNodesNode.Tags, and is useful for accessing the field via an interface.

func (*MergeNodesMergeNodesNode) GetUpdatedAt added in v0.7.0 

func (v *MergeNodesMergeNodesNode) GetUpdatedAt() string

GetUpdatedAt returns MergeNodesMergeNodesNode.UpdatedAt, and is useful for accessing the field via an interface.

type MergeNodesResponse added in v0.7.0 

type MergeNodesResponse struct {
	// Fold one node (source) into another (target), returning the updated
	// target. Per-field strategy: text fields (CONTENT/ABSTRACT/DESCRIPTION)
	// concatenate target-first; TAGS unions; DATA/PROPERTIES shallow-merge
	// with the target winning on key collisions; EDGES re-points the source's
	// relationships onto the target. 'include' selects which fields fold in
	// (omitted = all). 'deleteSource: true' hard-deletes the source afterward.
	// Honors per-memory write auth, encryption, revision history, abstract
	// staleness, and re-embedding (same invariants as createNode/updateNode).
	MergeNodes *MergeNodesMergeNodesNode `json:"mergeNodes"`
}

MergeNodesResponse is returned by MergeNodes on success.

func MergeNodes added in v0.7.0 

func MergeNodes(
	ctx_ context.Context,
	client_ graphql.Client,
	input *MergeNodesInput,
) (data_ *MergeNodesResponse, err_ error)

Fold one node (source) into another (target), returning the surviving target (mergeNodes, #186). input.source / input.target are ids or fully-qualified URNs. `include` selects which fields fold in (ABSTRACT/CONTENT/DATA/ DESCRIPTION/EDGES/PROPERTIES/TAGS); `deleteSource` hard-deletes it afterwards. Both optional inputs are omitempty so an unset one takes the server default (omit include = every mergeable field; omit deleteSource = keep the source).

func (*MergeNodesResponse) GetMergeNodes added in v0.7.0 

func (v *MergeNodesResponse) GetMergeNodes() *MergeNodesMergeNodesNode

GetMergeNodes returns MergeNodesResponse.MergeNodes, and is useful for accessing the field via an interface.

type MergeUsersMergeUsersUser added in v0.7.0 

type MergeUsersMergeUsersUser struct {
	UserFields `json:"-"`
}

MergeUsersMergeUsersUser includes the requested fields of the GraphQL type User.

func (*MergeUsersMergeUsersUser) GetEmail added in v0.7.0 

func (v *MergeUsersMergeUsersUser) GetEmail() *string

GetEmail returns MergeUsersMergeUsersUser.Email, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetExternalAppId added in v0.9.0 

func (v *MergeUsersMergeUsersUser) GetExternalAppId() *string

GetExternalAppId returns MergeUsersMergeUsersUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetExternalId added in v0.9.0 

func (v *MergeUsersMergeUsersUser) GetExternalId() *string

GetExternalId returns MergeUsersMergeUsersUser.ExternalId, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetGithubId added in v0.9.0 

func (v *MergeUsersMergeUsersUser) GetGithubId() *int

GetGithubId returns MergeUsersMergeUsersUser.GithubId, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetGithubUsername added in v0.7.0 

func (v *MergeUsersMergeUsersUser) GetGithubUsername() *string

GetGithubUsername returns MergeUsersMergeUsersUser.GithubUsername, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetHandle added in v0.7.0 

func (v *MergeUsersMergeUsersUser) GetHandle() *string

GetHandle returns MergeUsersMergeUsersUser.Handle, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetId added in v0.7.0 

func (v *MergeUsersMergeUsersUser) GetId() string

GetId returns MergeUsersMergeUsersUser.Id, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetIdentityProvider added in v0.9.0 

func (v *MergeUsersMergeUsersUser) GetIdentityProvider() *string

GetIdentityProvider returns MergeUsersMergeUsersUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetLinkedAt added in v0.9.0 

func (v *MergeUsersMergeUsersUser) GetLinkedAt() *string

GetLinkedAt returns MergeUsersMergeUsersUser.LinkedAt, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetName added in v0.7.0 

func (v *MergeUsersMergeUsersUser) GetName() *string

GetName returns MergeUsersMergeUsersUser.Name, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetRoles added in v0.7.0 

func (v *MergeUsersMergeUsersUser) GetRoles() []Role

GetRoles returns MergeUsersMergeUsersUser.Roles, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) GetUrn added in v0.14.0 

func (v *MergeUsersMergeUsersUser) GetUrn() *string

GetUrn returns MergeUsersMergeUsersUser.Urn, and is useful for accessing the field via an interface.

func (*MergeUsersMergeUsersUser) MarshalJSON added in v0.7.0 

func (v *MergeUsersMergeUsersUser) MarshalJSON() ([]byte, error)

func (*MergeUsersMergeUsersUser) UnmarshalJSON added in v0.7.0 

func (v *MergeUsersMergeUsersUser) UnmarshalJSON(b []byte) error

type MergeUsersResponse added in v0.7.0 

type MergeUsersResponse struct {
	// Consolidate a duplicate account into a surviving user. Source-only
	// identities and relationships move; duplicate role-bearing relationships
	// preserve the strongest live entitlement. The source is soft-deleted.
	// Platform admin, or an org admin/owner when both users are live members
	// of an organization they administer. The resulting merge is global.
	MergeUsers *MergeUsersMergeUsersUser `json:"mergeUsers"`
}

MergeUsersResponse is returned by MergeUsers on success.

func MergeUsers added in v0.7.0 

func MergeUsers(
	ctx_ context.Context,
	client_ graphql.Client,
	source string,
	target string,
) (data_ *MergeUsersResponse, err_ error)

mergeUsers globally consolidates a duplicate source user into a surviving target user; $source and $target each accept a PK id, bare handle, or fully-qualified hrn:user:<handle> URN, passed through verbatim. The source is soft-deleted; the target survives. Destructive + irreversible — `hadron user merge` gates it behind a confirmation. The server is authoritative for authorization (platform or org ADMIN/OWNER) and collision handling; the CLI adds no local checks. Spec cor:api:010:02.

func (*MergeUsersResponse) GetMergeUsers added in v0.7.0 

func (v *MergeUsersResponse) GetMergeUsers() *MergeUsersMergeUsersUser

GetMergeUsers returns MergeUsersResponse.MergeUsers, and is useful for accessing the field via an interface.

type MintActionTicketsInput added in v0.6.0 

type MintActionTicketsInput struct {
	// v1: comm.outbound only.
	Action string `json:"action"`
	// Scope tickets to one App (ref: PK or URN); omit for org-wide.
	AppRef    *string `json:"appRef,omitempty"`
	Count     int     `json:"count"`
	ExpiresAt *string `json:"expiresAt,omitempty"`
	// Ledger legibility — why these tickets exist.
	Note *string `json:"note,omitempty"`
	// Organization — ref: PK or URN.
	OrgRef string `json:"orgRef"`
}

func (*MintActionTicketsInput) GetAction added in v0.6.0 

func (v *MintActionTicketsInput) GetAction() string

GetAction returns MintActionTicketsInput.Action, and is useful for accessing the field via an interface.

func (*MintActionTicketsInput) GetAppRef added in v0.7.0 

func (v *MintActionTicketsInput) GetAppRef() *string

GetAppRef returns MintActionTicketsInput.AppRef, and is useful for accessing the field via an interface.

func (*MintActionTicketsInput) GetCount added in v0.6.0 

func (v *MintActionTicketsInput) GetCount() int

GetCount returns MintActionTicketsInput.Count, and is useful for accessing the field via an interface.

func (*MintActionTicketsInput) GetExpiresAt added in v0.6.0 

func (v *MintActionTicketsInput) GetExpiresAt() *string

GetExpiresAt returns MintActionTicketsInput.ExpiresAt, and is useful for accessing the field via an interface.

func (*MintActionTicketsInput) GetNote added in v0.6.0 

func (v *MintActionTicketsInput) GetNote() *string

GetNote returns MintActionTicketsInput.Note, and is useful for accessing the field via an interface.

func (*MintActionTicketsInput) GetOrgRef added in v0.7.0 

func (v *MintActionTicketsInput) GetOrgRef() string

GetOrgRef returns MintActionTicketsInput.OrgRef, and is useful for accessing the field via an interface.

type MintActionTicketsResponse added in v0.6.0 

type MintActionTicketsResponse struct {
	// Mint comm.outbound tickets into the org ledger (org-ADMIN; cor:acl:050:04).
	MintActionTickets int `json:"mintActionTickets"`
}

MintActionTicketsResponse is returned by MintActionTickets on success.

func MintActionTickets added in v0.6.0 

func MintActionTickets(
	ctx_ context.Context,
	client_ graphql.Client,
	input *MintActionTicketsInput,
) (data_ *MintActionTicketsResponse, err_ error)

Mint N consumable tickets into the org ledger; returns the count minted.

func (*MintActionTicketsResponse) GetMintActionTickets added in v0.6.0 

func (v *MintActionTicketsResponse) GetMintActionTickets() int

GetMintActionTickets returns MintActionTicketsResponse.MintActionTickets, and is useful for accessing the field via an interface.

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReport added in v0.19.0 

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReport struct {
	MemoryId string `json:"memoryId"`
	DryRun   bool   `json:"dryRun"`
	// True when this call minted the corpus.
	Minted bool `json:"minted"`
	// #1591 — how many nodes this call minted (0 on a dry run or refusal).
	MintedCount int `json:"mintedCount"`
	// #1591 — the locs this call minted, or would mint on a dry run, ordered by loc.
	MintLocs            []string                                                                                `json:"mintLocs"`
	StaleAbstractsBlock bool                                                                                    `json:"staleAbstractsBlock"`
	Blockers            []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding            `json:"blockers"`
	StaleAbstracts      []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding      `json:"staleAbstracts"`
	OpenQuestions       []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup `json:"openQuestions"`
}

MintMemoryNodesMintMemoryNodesSpecCorpusMintReport includes the requested fields of the GraphQL type SpecCorpusMintReport. The GraphQL type's documentation follows.

#1448 — the mint report. blockers must all be gone for a mint to succeed. staleAbstracts are listed separately; they block only when staleAbstractsBlock is true (once abstract re-affirmation is saved and deployed, server#1408). openQuestions never block.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetBlockers added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetBlockers() []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding

GetBlockers returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.Blockers, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetDryRun added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetDryRun() bool

GetDryRun returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.DryRun, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMemoryId added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMemoryId() string

GetMemoryId returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.MemoryId, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMintLocs added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMintLocs() []string

GetMintLocs returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.MintLocs, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMinted added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMinted() bool

GetMinted returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.Minted, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMintedCount added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetMintedCount() int

GetMintedCount returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.MintedCount, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetOpenQuestions added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetOpenQuestions() []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup

GetOpenQuestions returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.OpenQuestions, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetStaleAbstracts added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetStaleAbstracts() []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding

GetStaleAbstracts returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.StaleAbstracts, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetStaleAbstractsBlock added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport) GetStaleAbstractsBlock() bool

GetStaleAbstractsBlock returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReport.StaleAbstractsBlock, and is useful for accessing the field via an interface.

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding added in v0.19.0 

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding struct {
	Kind      SpecMintFindingKind `json:"kind"`
	Rule      *string             `json:"rule"`
	Loc       string              `json:"loc"`
	TargetLoc *string             `json:"targetLoc"`
	Message   string              `json:"message"`
}

MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding includes the requested fields of the GraphQL type SpecMintFinding. The GraphQL type's documentation follows.

#1448 — one item in a mint report. loc is where it was found; targetLoc the cited spec, for a reference.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetKind added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetKind() SpecMintFindingKind

GetKind returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding.Kind, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetLoc added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetLoc() string

GetLoc returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding.Loc, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetMessage added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetMessage() string

GetMessage returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding.Message, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetRule added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetRule() *string

GetRule returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding.Rule, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetTargetLoc added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding) GetTargetLoc() *string

GetTargetLoc returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportBlockersSpecMintFinding.TargetLoc, and is useful for accessing the field via an interface.

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup added in v0.19.0 

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup struct {
	Decider   *string                                                                                                          `json:"decider"`
	Questions []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion `json:"questions"`
}

MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup includes the requested fields of the GraphQL type SpecOpenQuestionGroup. The GraphQL type's documentation follows.

#1448 — open questions grouped by who decides; decider null means unassigned.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetDecider added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetDecider() *string

GetDecider returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup.Decider, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetQuestions added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetQuestions() []*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion

GetQuestions returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup.Questions, and is useful for accessing the field via an interface.

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion added in v0.19.0 

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion struct {
	Loc      string `json:"loc"`
	Question string `json:"question"`
}

MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion includes the requested fields of the GraphQL type SpecOpenQuestion. The GraphQL type's documentation follows.

#1448 — one open question in the corpus (report-only, never blocks minting).

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetLoc added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetLoc() string

GetLoc returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion.Loc, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetQuestion added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetQuestion() string

GetQuestion returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion.Question, and is useful for accessing the field via an interface.

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding added in v0.19.0 

type MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding struct {
	Kind      SpecMintFindingKind `json:"kind"`
	Rule      *string             `json:"rule"`
	Loc       string              `json:"loc"`
	TargetLoc *string             `json:"targetLoc"`
	Message   string              `json:"message"`
}

MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding includes the requested fields of the GraphQL type SpecMintFinding. The GraphQL type's documentation follows.

#1448 — one item in a mint report. loc is where it was found; targetLoc the cited spec, for a reference.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetKind added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetKind() SpecMintFindingKind

GetKind returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding.Kind, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetLoc added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetLoc() string

GetLoc returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding.Loc, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetMessage added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetMessage() string

GetMessage returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding.Message, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetRule added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetRule() *string

GetRule returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding.Rule, and is useful for accessing the field via an interface.

func (*MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetTargetLoc added in v0.19.0 

func (v *MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetTargetLoc() *string

GetTargetLoc returns MintMemoryNodesMintMemoryNodesSpecCorpusMintReportStaleAbstractsSpecMintFinding.TargetLoc, and is useful for accessing the field via an interface.

type MintMemoryNodesResponse added in v0.19.0 

type MintMemoryNodesResponse struct {
	// #1591 — mint every unminted live node of a memory, at once. Each node is
	// stamped with its current revision and that revision's approval hash
	// (Node.mintStatus); a minted node's moves then record URN aliases. Refuses
	// SPEC_CORPUS_MINT_BLOCKED while any blocker remains among the unminted
	// nodes: a placeholder, an unresolved reference, a structural lint error over
	// the citation-shaped nodes (nodetype-info, tag-spec, serialization-leak,
	// duplicate-loc), a stale abstract once staleAbstractsBlock is true,
	// NOT_APPROVED (the current revision is not approved), TAMPERED (approved
	// text changed outside the revision system), or CITES_UNMINTED (an
	// edge into another memory's node that is not minted). Nodes minted earlier
	// are not re-checked. dryRun returns the full report without minting. Any
	// writer of the memory. memoryRef accepts the ID or URN. A real run holds
	// every write to the memory off while it checks and stamps, and refuses
	// SPEC_CORPUS_BUSY (retryable) if a write is already in flight. Encrypted
	// memories are refused (SPEC_CORPUS_ENCRYPTED_UNSUPPORTED). Minting protects
	// nothing by itself: minted-spec permanence (#1468) is switched off for now.
	MintMemoryNodes *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport `json:"mintMemoryNodes"`
}

MintMemoryNodesResponse is returned by MintMemoryNodes on success.

func MintMemoryNodes added in v0.19.0 

func MintMemoryNodes(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	dryRun bool,
) (data_ *MintMemoryNodesResponse, err_ error)

func (*MintMemoryNodesResponse) GetMintMemoryNodes added in v0.19.0 

func (v *MintMemoryNodesResponse) GetMintMemoryNodes() *MintMemoryNodesMintMemoryNodesSpecCorpusMintReport

GetMintMemoryNodes returns MintMemoryNodesResponse.MintMemoryNodes, and is useful for accessing the field via an interface.

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReport added in v0.18.0 

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReport struct {
	MemoryId string `json:"memoryId"`
	DryRun   bool   `json:"dryRun"`
	// True when this call minted the corpus.
	Minted              bool                                                                                  `json:"minted"`
	StaleAbstractsBlock bool                                                                                  `json:"staleAbstractsBlock"`
	Blockers            []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding            `json:"blockers"`
	StaleAbstracts      []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding      `json:"staleAbstracts"`
	OpenQuestions       []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup `json:"openQuestions"`
}

MintSpecCorpusMintSpecCorpusSpecCorpusMintReport includes the requested fields of the GraphQL type SpecCorpusMintReport. The GraphQL type's documentation follows.

#1448 — the mint report. blockers must all be gone for a mint to succeed. staleAbstracts are listed separately; they block only when staleAbstractsBlock is true (once abstract re-affirmation is saved and deployed, server#1408). openQuestions never block.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetBlockers added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetBlockers() []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding

GetBlockers returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReport.Blockers, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetDryRun added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetDryRun() bool

GetDryRun returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReport.DryRun, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetMemoryId added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetMemoryId() string

GetMemoryId returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReport.MemoryId, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetMinted added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetMinted() bool

GetMinted returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReport.Minted, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetOpenQuestions added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetOpenQuestions() []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup

GetOpenQuestions returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReport.OpenQuestions, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetStaleAbstracts added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetStaleAbstracts() []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding

GetStaleAbstracts returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReport.StaleAbstracts, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetStaleAbstractsBlock added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport) GetStaleAbstractsBlock() bool

GetStaleAbstractsBlock returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReport.StaleAbstractsBlock, and is useful for accessing the field via an interface.

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding added in v0.18.0 

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding struct {
	Kind      SpecMintFindingKind `json:"kind"`
	Rule      *string             `json:"rule"`
	Loc       string              `json:"loc"`
	TargetLoc *string             `json:"targetLoc"`
	Message   string              `json:"message"`
}

MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding includes the requested fields of the GraphQL type SpecMintFinding. The GraphQL type's documentation follows.

#1448 — one item in a mint report. loc is where it was found; targetLoc the cited spec, for a reference.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetKind added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetKind() SpecMintFindingKind

GetKind returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding.Kind, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetLoc added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetLoc() string

GetLoc returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding.Loc, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetMessage added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetMessage() string

GetMessage returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding.Message, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetRule added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetRule() *string

GetRule returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding.Rule, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetTargetLoc added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding) GetTargetLoc() *string

GetTargetLoc returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportBlockersSpecMintFinding.TargetLoc, and is useful for accessing the field via an interface.

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup added in v0.18.0 

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup struct {
	Decider   *string                                                                                                        `json:"decider"`
	Questions []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion `json:"questions"`
}

MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup includes the requested fields of the GraphQL type SpecOpenQuestionGroup. The GraphQL type's documentation follows.

#1448 — open questions grouped by who decides; decider null means unassigned.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetDecider added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetDecider() *string

GetDecider returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup.Decider, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetQuestions added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup) GetQuestions() []*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion

GetQuestions returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroup.Questions, and is useful for accessing the field via an interface.

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion added in v0.18.0 

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion struct {
	Loc      string `json:"loc"`
	Question string `json:"question"`
}

MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion includes the requested fields of the GraphQL type SpecOpenQuestion. The GraphQL type's documentation follows.

#1448 — one open question in the corpus (report-only, never blocks minting).

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetLoc added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetLoc() string

GetLoc returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion.Loc, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetQuestion added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion) GetQuestion() string

GetQuestion returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportOpenQuestionsSpecOpenQuestionGroupQuestionsSpecOpenQuestion.Question, and is useful for accessing the field via an interface.

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding added in v0.18.0 

type MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding struct {
	Kind      SpecMintFindingKind `json:"kind"`
	Rule      *string             `json:"rule"`
	Loc       string              `json:"loc"`
	TargetLoc *string             `json:"targetLoc"`
	Message   string              `json:"message"`
}

MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding includes the requested fields of the GraphQL type SpecMintFinding. The GraphQL type's documentation follows.

#1448 — one item in a mint report. loc is where it was found; targetLoc the cited spec, for a reference.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetKind added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetKind() SpecMintFindingKind

GetKind returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding.Kind, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetLoc added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetLoc() string

GetLoc returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding.Loc, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetMessage added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetMessage() string

GetMessage returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding.Message, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetRule added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetRule() *string

GetRule returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding.Rule, and is useful for accessing the field via an interface.

func (*MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetTargetLoc added in v0.18.0 

func (v *MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding) GetTargetLoc() *string

GetTargetLoc returns MintSpecCorpusMintSpecCorpusSpecCorpusMintReportStaleAbstractsSpecMintFinding.TargetLoc, and is useful for accessing the field via an interface.

type MintSpecCorpusResponse added in v0.18.0 

type MintSpecCorpusResponse struct {
	// #1448, generalized by #1591 — the same operation as mintMemoryNodes, kept under its original name.
	MintSpecCorpus *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport `json:"mintSpecCorpus"`
}

MintSpecCorpusResponse is returned by MintSpecCorpus on success.

func MintSpecCorpus added in v0.18.0 

func MintSpecCorpus(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	dryRun bool,
) (data_ *MintSpecCorpusResponse, err_ error)

#1448 — mint the corpus. dryRun returns the full report without minting; a real run refuses SPEC_CORPUS_MINT_BLOCKED while a blocker remains.

func (*MintSpecCorpusResponse) GetMintSpecCorpus added in v0.18.0 

func (v *MintSpecCorpusResponse) GetMintSpecCorpus() *MintSpecCorpusMintSpecCorpusSpecCorpusMintReport

GetMintSpecCorpus returns MintSpecCorpusResponse.MintSpecCorpus, and is useful for accessing the field via an interface.

type MoveNodeMoveNode added in v0.7.0 

type MoveNodeMoveNode struct {
	Id string `json:"id"`
	// Fully-qualified node URN (hrn:node:<root>:<memory>:<loc>), composed server-side from the node's memory URN + loc (#481). Carried by every Node-returning surface (findNodes, node, appNodes, nodeBatch, mutation returns).
	Urn      string `json:"urn"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string `json:"nodeType"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role *string  `json:"role"`
	Tags []string `json:"tags"`
	Seq  *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool  `json:"isRunnable"`
	UpdatedAt  string `json:"updatedAt"`
}

MoveNodeMoveNode includes the requested fields of the GraphQL type Node.

func (*MoveNodeMoveNode) GetId added in v0.7.0 

func (v *MoveNodeMoveNode) GetId() string

GetId returns MoveNodeMoveNode.Id, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetIsRunnable added in v0.7.0 

func (v *MoveNodeMoveNode) GetIsRunnable() *bool

GetIsRunnable returns MoveNodeMoveNode.IsRunnable, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetLoc added in v0.7.0 

func (v *MoveNodeMoveNode) GetLoc() string

GetLoc returns MoveNodeMoveNode.Loc, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetMemoryId added in v0.7.0 

func (v *MoveNodeMoveNode) GetMemoryId() string

GetMemoryId returns MoveNodeMoveNode.MemoryId, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetName added in v0.7.0 

func (v *MoveNodeMoveNode) GetName() string

GetName returns MoveNodeMoveNode.Name, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetNodeType added in v0.7.0 

func (v *MoveNodeMoveNode) GetNodeType() string

GetNodeType returns MoveNodeMoveNode.NodeType, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetRole added in v0.15.0 

func (v *MoveNodeMoveNode) GetRole() *string

GetRole returns MoveNodeMoveNode.Role, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetSeq added in v0.14.0 

func (v *MoveNodeMoveNode) GetSeq() *int

GetSeq returns MoveNodeMoveNode.Seq, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetTags added in v0.7.0 

func (v *MoveNodeMoveNode) GetTags() []string

GetTags returns MoveNodeMoveNode.Tags, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetUpdatedAt added in v0.7.0 

func (v *MoveNodeMoveNode) GetUpdatedAt() string

GetUpdatedAt returns MoveNodeMoveNode.UpdatedAt, and is useful for accessing the field via an interface.

func (*MoveNodeMoveNode) GetUrn added in v0.7.0 

func (v *MoveNodeMoveNode) GetUrn() string

GetUrn returns MoveNodeMoveNode.Urn, and is useful for accessing the field via an interface.

type MoveNodeResponse added in v0.7.0 

type MoveNodeResponse struct {
	// Relocate a node (#564). 'sourceRef' is the node's PK or fully-qualified
	// URN. The destination is EITHER 'targetUrn' (the node's new full URN — new
	// memory and/or loc) OR 'targetMemoryRef' (a memory ID/URN; the node keeps
	// its current loc, only its memory changes) — supply exactly one. The node
	// keeps its id, so all incoming/outgoing edge references stay valid. Fails
	// loudly with NODE_ALREADY_EXISTS if a live node already occupies the
	// destination. Requires write access to both the source and destination
	// memories. On a cross-memory move, select Node.moveLinkWarnings to see
	// raw relative content links that now miss or resolve to another node.
	MoveNode *MoveNodeMoveNode `json:"moveNode"`
}

MoveNodeResponse is returned by MoveNode on success.

func MoveNode added in v0.7.0 

func MoveNode(
	ctx_ context.Context,
	client_ graphql.Client,
	sourceRef string,
	targetUrn *string,
	targetMemoryRef *string,
) (data_ *MoveNodeResponse, err_ error)

Relocate a node (#564). $sourceRef is the node's id or full URN; the destination is EXACTLY ONE of $targetUrn (the node's new full URN — new memory and/or loc) or $targetMemoryRef (a memory id/URN; the node keeps its loc, only its memory changes). The node keeps its id, so edge references stay valid. Optional destination vars must be omitted (not sent as null) so the server sees exactly one. Backs `hadron node move`.

func (*MoveNodeResponse) GetMoveNode added in v0.7.0 

func (v *MoveNodeResponse) GetMoveNode() *MoveNodeMoveNode

GetMoveNode returns MoveNodeResponse.MoveNode, and is useful for accessing the field via an interface.

type MyUserApiKeysMyUserApiKeysUserApiKey added in v0.3.0 

type MyUserApiKeysMyUserApiKeysUserApiKey struct {
	UserApiKeyFields `json:"-"`
}

MyUserApiKeysMyUserApiKeysUserApiKey includes the requested fields of the GraphQL type UserApiKey. The GraphQL type's documentation follows.

025-oauth-for-mcp: user-scoped bearer-token credential. Mirrors the AppKey shape but resolves to a User instead of an App. Surfaced to the portal revocation UI (Phase 3) so users can audit + revoke their own keys. userId is intentionally absent — for self-service v1 the caller is always the owner; admin-tooling auditability is out of scope (see contracts/graphql-mutations.md, PR-137 delta D1).

func (*MyUserApiKeysMyUserApiKeysUserApiKey) GetCreatedAt added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) GetCreatedAt() string

GetCreatedAt returns MyUserApiKeysMyUserApiKeysUserApiKey.CreatedAt, and is useful for accessing the field via an interface.

func (*MyUserApiKeysMyUserApiKeysUserApiKey) GetId added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) GetId() string

GetId returns MyUserApiKeysMyUserApiKeysUserApiKey.Id, and is useful for accessing the field via an interface.

func (*MyUserApiKeysMyUserApiKeysUserApiKey) GetIssuedVia added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) GetIssuedVia() *string

GetIssuedVia returns MyUserApiKeysMyUserApiKeysUserApiKey.IssuedVia, and is useful for accessing the field via an interface.

func (*MyUserApiKeysMyUserApiKeysUserApiKey) GetKeyPreview added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) GetKeyPreview() string

GetKeyPreview returns MyUserApiKeysMyUserApiKeysUserApiKey.KeyPreview, and is useful for accessing the field via an interface.

func (*MyUserApiKeysMyUserApiKeysUserApiKey) GetLabel added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) GetLabel() *string

GetLabel returns MyUserApiKeysMyUserApiKeysUserApiKey.Label, and is useful for accessing the field via an interface.

func (*MyUserApiKeysMyUserApiKeysUserApiKey) GetLastUsedAt added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) GetLastUsedAt() *string

GetLastUsedAt returns MyUserApiKeysMyUserApiKeysUserApiKey.LastUsedAt, and is useful for accessing the field via an interface.

func (*MyUserApiKeysMyUserApiKeysUserApiKey) GetRevokedAt added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) GetRevokedAt() *string

GetRevokedAt returns MyUserApiKeysMyUserApiKeysUserApiKey.RevokedAt, and is useful for accessing the field via an interface.

func (*MyUserApiKeysMyUserApiKeysUserApiKey) MarshalJSON added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) MarshalJSON() ([]byte, error)

func (*MyUserApiKeysMyUserApiKeysUserApiKey) UnmarshalJSON added in v0.3.0 

func (v *MyUserApiKeysMyUserApiKeysUserApiKey) UnmarshalJSON(b []byte) error

type MyUserApiKeysResponse added in v0.3.0 

type MyUserApiKeysResponse struct {
	// 025-oauth-for-mcp FR-004: list the calling User's API keys (active
	// + revoked, createdAt DESC). Powers Phase 3's portal revocation UI
	// (SC-006). Rejected with UNAUTHENTICATED for AppKey-resolved
	// callers (no user in context). PR-137 review delta D5 — Query
	// not present in PR 137.
	MyUserApiKeys []*MyUserApiKeysMyUserApiKeysUserApiKey `json:"myUserApiKeys"`
}

MyUserApiKeysResponse is returned by MyUserApiKeys on success.

func MyUserApiKeys added in v0.3.0 

func MyUserApiKeys(
	ctx_ context.Context,
	client_ graphql.Client,
) (data_ *MyUserApiKeysResponse, err_ error)

func (*MyUserApiKeysResponse) GetMyUserApiKeys added in v0.3.0 

func (v *MyUserApiKeysResponse) GetMyUserApiKeys() []*MyUserApiKeysMyUserApiKeysUserApiKey

GetMyUserApiKeys returns MyUserApiKeysResponse.MyUserApiKeys, and is useful for accessing the field via an interface.

type NodeApprovalFields added in v0.19.0 

type NodeApprovalFields struct {
	// The approved revision number (Node.revision at approval time).
	Revision   int    `json:"revision"`
	ApprovedAt string `json:"approvedAt"`
	// The approving user's public identifiers; null when the approver was not a user (see approvedByInfo).
	ApprovedBy *NodeApprovalFieldsApprovedByNodeRevisionEditor `json:"approvedBy"`
	// The approving principal when no user is known, e.g. app:<id>.
	ApprovedByInfo *string `json:"approvedByInfo"`
	// Approval hash v1 at approval time: 64 lowercase hex of SHA-256 over the canonical title/abstract/content serialization (src/lib/approvalHash.ts).
	Hash string `json:"hash"`
}

NodeApprovalFields includes the GraphQL fields of NodeApproval requested by the fragment NodeApprovalFields. The GraphQL type's documentation follows.

#1591 — one recorded approval of a node revision.

func (*NodeApprovalFields) GetApprovedAt added in v0.19.0 

func (v *NodeApprovalFields) GetApprovedAt() string

GetApprovedAt returns NodeApprovalFields.ApprovedAt, and is useful for accessing the field via an interface.

func (*NodeApprovalFields) GetApprovedBy added in v0.19.0 

func (v *NodeApprovalFields) GetApprovedBy() *NodeApprovalFieldsApprovedByNodeRevisionEditor

GetApprovedBy returns NodeApprovalFields.ApprovedBy, and is useful for accessing the field via an interface.

func (*NodeApprovalFields) GetApprovedByInfo added in v0.19.0 

func (v *NodeApprovalFields) GetApprovedByInfo() *string

GetApprovedByInfo returns NodeApprovalFields.ApprovedByInfo, and is useful for accessing the field via an interface.

func (*NodeApprovalFields) GetHash added in v0.19.0 

func (v *NodeApprovalFields) GetHash() string

GetHash returns NodeApprovalFields.Hash, and is useful for accessing the field via an interface.

func (*NodeApprovalFields) GetRevision added in v0.19.0 

func (v *NodeApprovalFields) GetRevision() int

GetRevision returns NodeApprovalFields.Revision, and is useful for accessing the field via an interface.

type NodeApprovalFieldsApprovedByNodeRevisionEditor added in v0.19.0 

type NodeApprovalFieldsApprovedByNodeRevisionEditor struct {
	Handle *string `json:"handle"`
	Urn    *string `json:"urn"`
}

NodeApprovalFieldsApprovedByNodeRevisionEditor includes the requested fields of the GraphQL type NodeRevisionEditor. The GraphQL type's documentation follows.

A revision's editor resolved to PUBLIC IDENTIFIERS ONLY (#617). Deliberately excludes name / email / any PII — resolving editedBy must never widen the disclosure surface. handle + urn are the same public identifiers the users search already exposes, so no per-caller visibility gate applies.

func (*NodeApprovalFieldsApprovedByNodeRevisionEditor) GetHandle added in v0.19.0 

func (v *NodeApprovalFieldsApprovedByNodeRevisionEditor) GetHandle() *string

GetHandle returns NodeApprovalFieldsApprovedByNodeRevisionEditor.Handle, and is useful for accessing the field via an interface.

func (*NodeApprovalFieldsApprovedByNodeRevisionEditor) GetUrn added in v0.19.0 

func (v *NodeApprovalFieldsApprovedByNodeRevisionEditor) GetUrn() *string

GetUrn returns NodeApprovalFieldsApprovedByNodeRevisionEditor.Urn, and is useful for accessing the field via an interface.

type NodeApprovalState added in v0.19.0 

type NodeApprovalState string

#1591 — whether a node's current revision is approved. 

const (
	// The current revision is approved.
	NodeApprovalStateApproved NodeApprovalState = "APPROVED"
	// Never approved.
	NodeApprovalStateNotApproved NodeApprovalState = "NOT_APPROVED"
	// Approved once, edited since: the approval covers an older revision.
	NodeApprovalStateSuperseded NodeApprovalState = "SUPERSEDED"
)

type NodeApprovalStatusFields added in v0.19.0 

type NodeApprovalStatusFields struct {
	State NodeApprovalState `json:"state"`
	// The latest approval on record; null when NOT_APPROVED.
	Approval *NodeApprovalStatusFieldsApprovalNodeApproval `json:"approval"`
}

NodeApprovalStatusFields includes the GraphQL fields of NodeApprovalStatus requested by the fragment NodeApprovalStatusFields. The GraphQL type's documentation follows.

#1591 — a node's approval state plus its latest approval.

func (*NodeApprovalStatusFields) GetApproval added in v0.19.0 

func (v *NodeApprovalStatusFields) GetApproval() *NodeApprovalStatusFieldsApprovalNodeApproval

GetApproval returns NodeApprovalStatusFields.Approval, and is useful for accessing the field via an interface.

func (*NodeApprovalStatusFields) GetState added in v0.19.0 

func (v *NodeApprovalStatusFields) GetState() NodeApprovalState

GetState returns NodeApprovalStatusFields.State, and is useful for accessing the field via an interface.

type NodeApprovalStatusFieldsApprovalNodeApproval added in v0.19.0 

type NodeApprovalStatusFieldsApprovalNodeApproval struct {
	NodeApprovalFields `json:"-"`
}

NodeApprovalStatusFieldsApprovalNodeApproval includes the requested fields of the GraphQL type NodeApproval. The GraphQL type's documentation follows.

#1591 — one recorded approval of a node revision.

func (*NodeApprovalStatusFieldsApprovalNodeApproval) GetApprovedAt added in v0.19.0 

func (v *NodeApprovalStatusFieldsApprovalNodeApproval) GetApprovedAt() string

GetApprovedAt returns NodeApprovalStatusFieldsApprovalNodeApproval.ApprovedAt, and is useful for accessing the field via an interface.

func (*NodeApprovalStatusFieldsApprovalNodeApproval) GetApprovedBy added in v0.19.0 

func (v *NodeApprovalStatusFieldsApprovalNodeApproval) GetApprovedBy() *NodeApprovalFieldsApprovedByNodeRevisionEditor

GetApprovedBy returns NodeApprovalStatusFieldsApprovalNodeApproval.ApprovedBy, and is useful for accessing the field via an interface.

func (*NodeApprovalStatusFieldsApprovalNodeApproval) GetApprovedByInfo added in v0.19.0 

func (v *NodeApprovalStatusFieldsApprovalNodeApproval) GetApprovedByInfo() *string

GetApprovedByInfo returns NodeApprovalStatusFieldsApprovalNodeApproval.ApprovedByInfo, and is useful for accessing the field via an interface.

func (*NodeApprovalStatusFieldsApprovalNodeApproval) GetHash added in v0.19.0 

func (v *NodeApprovalStatusFieldsApprovalNodeApproval) GetHash() string

GetHash returns NodeApprovalStatusFieldsApprovalNodeApproval.Hash, and is useful for accessing the field via an interface.

func (*NodeApprovalStatusFieldsApprovalNodeApproval) GetRevision added in v0.19.0 

func (v *NodeApprovalStatusFieldsApprovalNodeApproval) GetRevision() int

GetRevision returns NodeApprovalStatusFieldsApprovalNodeApproval.Revision, and is useful for accessing the field via an interface.

func (*NodeApprovalStatusFieldsApprovalNodeApproval) MarshalJSON added in v0.19.0 

func (v *NodeApprovalStatusFieldsApprovalNodeApproval) MarshalJSON() ([]byte, error)

func (*NodeApprovalStatusFieldsApprovalNodeApproval) UnmarshalJSON added in v0.19.0 

func (v *NodeApprovalStatusFieldsApprovalNodeApproval) UnmarshalJSON(b []byte) error

type NodeAuthorshipFields added in v0.19.0 

type NodeAuthorshipFields struct {
	Kind         NodeAuthorshipKind                           `json:"kind"`
	AuthoredAt   string                                       `json:"authoredAt"`
	TaskRef      *string                                      `json:"taskRef"`
	TaskRevision *int                                         `json:"taskRevision"`
	Human        *NodeAuthorshipFieldsHumanNodeRevisionEditor `json:"human"`
}

#1326 — attribution of a content state. taskRef is REDACTED (null) by the server unless the task's memory is independently readable; kind still says TASK, so a redacted task is not mistaken for a human.

func (*NodeAuthorshipFields) GetAuthoredAt added in v0.19.0 

func (v *NodeAuthorshipFields) GetAuthoredAt() string

GetAuthoredAt returns NodeAuthorshipFields.AuthoredAt, and is useful for accessing the field via an interface.

func (*NodeAuthorshipFields) GetHuman added in v0.19.0 

func (v *NodeAuthorshipFields) GetHuman() *NodeAuthorshipFieldsHumanNodeRevisionEditor

GetHuman returns NodeAuthorshipFields.Human, and is useful for accessing the field via an interface.

func (*NodeAuthorshipFields) GetKind added in v0.19.0 

func (v *NodeAuthorshipFields) GetKind() NodeAuthorshipKind

GetKind returns NodeAuthorshipFields.Kind, and is useful for accessing the field via an interface.

func (*NodeAuthorshipFields) GetTaskRef added in v0.19.0 

func (v *NodeAuthorshipFields) GetTaskRef() *string

GetTaskRef returns NodeAuthorshipFields.TaskRef, and is useful for accessing the field via an interface.

func (*NodeAuthorshipFields) GetTaskRevision added in v0.19.0 

func (v *NodeAuthorshipFields) GetTaskRevision() *int

GetTaskRevision returns NodeAuthorshipFields.TaskRevision, and is useful for accessing the field via an interface.

type NodeAuthorshipFieldsHumanNodeRevisionEditor added in v0.19.0 

type NodeAuthorshipFieldsHumanNodeRevisionEditor struct {
	Handle *string `json:"handle"`
	Urn    *string `json:"urn"`
}

NodeAuthorshipFieldsHumanNodeRevisionEditor includes the requested fields of the GraphQL type NodeRevisionEditor. The GraphQL type's documentation follows.

A revision's editor resolved to PUBLIC IDENTIFIERS ONLY (#617). Deliberately excludes name / email / any PII — resolving editedBy must never widen the disclosure surface. handle + urn are the same public identifiers the users search already exposes, so no per-caller visibility gate applies.

func (*NodeAuthorshipFieldsHumanNodeRevisionEditor) GetHandle added in v0.19.0 

func (v *NodeAuthorshipFieldsHumanNodeRevisionEditor) GetHandle() *string

GetHandle returns NodeAuthorshipFieldsHumanNodeRevisionEditor.Handle, and is useful for accessing the field via an interface.

func (*NodeAuthorshipFieldsHumanNodeRevisionEditor) GetUrn added in v0.19.0 

func (v *NodeAuthorshipFieldsHumanNodeRevisionEditor) GetUrn() *string

GetUrn returns NodeAuthorshipFieldsHumanNodeRevisionEditor.Urn, and is useful for accessing the field via an interface.

type NodeAuthorshipKind added in v0.19.0 

type NodeAuthorshipKind string
const (
	NodeAuthorshipKindHuman NodeAuthorshipKind = "HUMAN"
	NodeAuthorshipKindTask  NodeAuthorshipKind = "TASK"
)

type NodeBatchNodeBatchNodeBatchResult added in v0.2.0 

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

NodeBatchNodeBatchNodeBatchResult includes the requested fields of the GraphQL type NodeBatchResult. The GraphQL type's documentation follows.

Spec cor:api:040 — result envelope for the batch node read (nodeBatch). 'nodes' is the authorized, existing subset (input order for a ref set, loc order for a prefix). 'unavailable' and 'omitted' are both lists of REFS, not node objects. 'unavailable' lists the requested refs that were denied OR not found — indistinguishable, so the result never discloses whether an unreadable node exists. 'truncated' is true when the response-size cap was reached, and 'omitted' then carries the refs of the nodes dropped to stay under it. (Over the node-count cap the query errors instead — never a silent short read.) Both lists echo the caller's OWN ref strings for the 'refs' form — pass a URN, get that URN back, not a primary key you never sent — and node ids for the prefix form, which has no caller refs.

func (*NodeBatchNodeBatchNodeBatchResult) GetNodes added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResult) GetNodes() []*NodeBatchNodeBatchNodeBatchResultNodesNode

GetNodes returns NodeBatchNodeBatchNodeBatchResult.Nodes, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResult) GetOmitted added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResult) GetOmitted() []string

GetOmitted returns NodeBatchNodeBatchNodeBatchResult.Omitted, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResult) GetTruncated added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResult) GetTruncated() bool

GetTruncated returns NodeBatchNodeBatchNodeBatchResult.Truncated, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResult) GetUnavailable added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResult) GetUnavailable() []string

GetUnavailable returns NodeBatchNodeBatchNodeBatchResult.Unavailable, and is useful for accessing the field via an interface.

type NodeBatchNodeBatchNodeBatchResultNodesNode added in v0.2.0 

type NodeBatchNodeBatchNodeBatchResultNodesNode struct {
	Id string `json:"id"`
	// Fully-qualified node URN (hrn:node:<root>:<memory>:<loc>), composed server-side from the node's memory URN + loc (#481). Carried by every Node-returning surface (findNodes, node, appNodes, nodeBatch, mutation returns).
	Urn string `json:"urn"`
	// #881 — the portal URL that opens this node, built server-side so no client
	// ever has to construct one (constructing means guessing which URN spelling
	// the /app/u/<urn> route resolves, and the legacy '::' forms in circulation
	// make that guess wrong). Form: <portal-origin>/app/u/<urn>, the portal's
	// stable URN-alias route. NULL when the deployment has no portal origin
	// configured (FRONTEND_URL) — a link to the wrong host is worse than none, so
	// clients render the field only when present.
	PortalUrl *string `json:"portalUrl"`
	MemoryId  string  `json:"memoryId"`
	Loc       string  `json:"loc"`
	Name      string  `json:"name"`
	Alias     *string `json:"alias"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string `json:"nodeType"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role *string `json:"role"`
	// #725 — the COLLECTION discriminator: which domain object this node is an
	// instance of, e.g. "competitor" / "insight". Validated against the memory's
	// property schema when it has one. NULL for an ordinary node.
	//
	// NOT 'nodeType' (the platform-kind axis, which drives retrieval) and NOT
	// 'role' (what the node is for; role can be filtered explicitly but does not
	// change default ranking or rendering).
	ObjectType *string `json:"objectType"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable  *bool   `json:"isRunnable"`
	Description *string `json:"description"`
	// Paragraph-length summary of this node. Opt-in on hadron_get_node via the contentScope parameter. hadron_find_nodes preview surfacing ships in spec 031 US2 — not yet live. Never surfaced in hadron_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: the abstract may not reflect current content when the two differ, OR when this is NULL on a node that has both an abstract and content (#1128 — an abstract written before the body existed was never fingerprinted, so it has never been checked against it; that reads as unverified, not as verified). NULL is only a clean state when the node has no abstract, or no content for the abstract to describe. Note restoreNodeRevision restores this field verbatim, so restoring a snapshot taken while it was NULL reinstates the unverified state — correctly, since that abstract has never been checked against the restored 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"`
	CreatedAt          string                                                         `json:"createdAt"`
	UpdatedAt          string                                                         `json:"updatedAt"`
	OutgoingEdges      []*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge `json:"outgoingEdges"`
	IncomingEdges      []*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge `json:"incomingEdges"`
}

NodeBatchNodeBatchNodeBatchResultNodesNode includes the requested fields of the GraphQL type Node.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetAbstract added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetAbstract() *string

GetAbstract returns NodeBatchNodeBatchNodeBatchResultNodesNode.Abstract, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetAbstractOriginHash added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetAbstractOriginHash() *string

GetAbstractOriginHash returns NodeBatchNodeBatchNodeBatchResultNodesNode.AbstractOriginHash, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetAlias added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetAlias() *string

GetAlias returns NodeBatchNodeBatchNodeBatchResultNodesNode.Alias, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetContent added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetContent() *string

GetContent returns NodeBatchNodeBatchNodeBatchResultNodesNode.Content, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetCreatedAt added in v0.9.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetCreatedAt() string

GetCreatedAt returns NodeBatchNodeBatchNodeBatchResultNodesNode.CreatedAt, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetData added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetData() *json.RawMessage

GetData returns NodeBatchNodeBatchNodeBatchResultNodesNode.Data, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetDescription added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetDescription() *string

GetDescription returns NodeBatchNodeBatchNodeBatchResultNodesNode.Description, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetId added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetId() string

GetId returns NodeBatchNodeBatchNodeBatchResultNodesNode.Id, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetIncomingEdges added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetIncomingEdges() []*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge

GetIncomingEdges returns NodeBatchNodeBatchNodeBatchResultNodesNode.IncomingEdges, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetIsRunnable added in v0.9.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetIsRunnable() *bool

GetIsRunnable returns NodeBatchNodeBatchNodeBatchResultNodesNode.IsRunnable, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetLoc added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetLoc() string

GetLoc returns NodeBatchNodeBatchNodeBatchResultNodesNode.Loc, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetMemoryId added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetMemoryId() string

GetMemoryId returns NodeBatchNodeBatchNodeBatchResultNodesNode.MemoryId, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetName added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetName() string

GetName returns NodeBatchNodeBatchNodeBatchResultNodesNode.Name, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetNodeType added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetNodeType() string

GetNodeType returns NodeBatchNodeBatchNodeBatchResultNodesNode.NodeType, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetObjectType added in v0.9.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetObjectType() *string

GetObjectType returns NodeBatchNodeBatchNodeBatchResultNodesNode.ObjectType, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetOutgoingEdges added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetOutgoingEdges() []*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge

GetOutgoingEdges returns NodeBatchNodeBatchNodeBatchResultNodesNode.OutgoingEdges, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetPortalUrl added in v0.12.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetPortalUrl() *string

GetPortalUrl returns NodeBatchNodeBatchNodeBatchResultNodesNode.PortalUrl, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetProperties added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetProperties() *json.RawMessage

GetProperties returns NodeBatchNodeBatchNodeBatchResultNodesNode.Properties, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetRole added in v0.15.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetRole() *string

GetRole returns NodeBatchNodeBatchNodeBatchResultNodesNode.Role, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetSeq added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetSeq() *int

GetSeq returns NodeBatchNodeBatchNodeBatchResultNodesNode.Seq, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetTags added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetTags() []string

GetTags returns NodeBatchNodeBatchNodeBatchResultNodesNode.Tags, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetUpdatedAt added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetUpdatedAt() string

GetUpdatedAt returns NodeBatchNodeBatchNodeBatchResultNodesNode.UpdatedAt, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNode) GetUrn added in v0.12.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNode) GetUrn() string

GetUrn returns NodeBatchNodeBatchNodeBatchResultNodesNode.Urn, and is useful for accessing the field via an interface.

type NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge added in v0.2.0 

type NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge struct {
	Id string `json:"id"`
	// Free-form relationship name (e.g. imports, depends_on). Optional since
	// spec 037 — loc is the identity. (Was the required 'label'.)
	Name *string `json:"name"`
	// Colon-delimited path within the (source node's) memory — the edge's
	// identity and the suffix of its URN hrn:edge:<root>:<memory>:<loc>.
	Loc string `json:"loc"`
	// Resolution-order hook (lower = earlier; default 0). When two edges
	// share a priority, fall back to insertion order.
	Priority int `json:"priority"`
	// If true, this edge can be executed/run (task automation, conversation
	// transitions). Mirrors Node.isRunnable.
	IsRunnable *bool `json:"isRunnable"`
	// The source node. NULLABLE (#781): null when the caller cannot read the source node's memory — a cross-memory edge (e.g. reached via incomingEdges) must not expose an endpoint in a memory the caller can't read. For a same-memory edge the caller can already see, this is always present.
	Source *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode `json:"source"`
}

NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge includes the requested fields of the GraphQL type Edge.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetId added in v0.9.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetId() string

GetId returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge.Id, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetIsRunnable added in v0.3.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetIsRunnable() *bool

GetIsRunnable returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge.IsRunnable, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetLoc added in v0.3.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetLoc() string

GetLoc returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge.Loc, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetName added in v0.3.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetName() *string

GetName returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge.Name, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetPriority added in v0.9.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetPriority() int

GetPriority returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge.Priority, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetSource added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge) GetSource() *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode

GetSource returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdge.Source, and is useful for accessing the field via an interface.

type NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode added in v0.2.0 

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

NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode includes the requested fields of the GraphQL type Node.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode) GetId added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode) GetId() string

GetId returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode.Id, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode) GetLoc added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode) GetLoc() string

GetLoc returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode.Loc, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode) GetMemoryId added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode) GetMemoryId() string

GetMemoryId returns NodeBatchNodeBatchNodeBatchResultNodesNodeIncomingEdgesEdgeSourceNode.MemoryId, and is useful for accessing the field via an interface.

type NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge added in v0.2.0 

type NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge struct {
	Id string `json:"id"`
	// Free-form relationship name (e.g. imports, depends_on). Optional since
	// spec 037 — loc is the identity. (Was the required 'label'.)
	Name *string `json:"name"`
	// Colon-delimited path within the (source node's) memory — the edge's
	// identity and the suffix of its URN hrn:edge:<root>:<memory>:<loc>.
	Loc string `json:"loc"`
	// Longer gloss carried for API consumers. NOT rendered on agent node reads,
	// whose Related:/Referenced by: lines show the edge name (#721: name is the
	// display label). Put the label you want seen in name (#1057).
	Description *string `json:"description"`
	// If true, this edge can be executed/run (task automation, conversation
	// transitions). Mirrors Node.isRunnable.
	IsRunnable *bool `json:"isRunnable"`
	// Resolution-order hook (lower = earlier; default 0). When two edges
	// share a priority, fall back to insertion order.
	Priority int `json:"priority"`
	// JSONLogic gating expression. Null = always fires. Validated against
	// the v1 operator subset and the FOUR variable scopes — memory.*, chat.*,
	// agent.*, message.data.* (VALID_SCOPE_PREFIXES; anything else is
	// UNKNOWN_SCOPE). The time builtins now() and today() are a SEPARATE
	// constant, not a fifth scope: they are whole references rather than
	// prefixes, and the evaluator pre-resolves them from the request clock.
	// Until #1246 this said "five variable scopes" and listed the builtins as
	// one of them — a count and a category error in one sentence.
	// See hadron-docs/docs/reference/edge-conditions.md.
	Condition *json.RawMessage `json:"condition"`
	// The target node. NULLABLE (#781): null when the caller cannot read the target node's memory (a cross-memory edge's far endpoint). For a same-memory edge, always present.
	Target *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode `json:"target"`
}

NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge includes the requested fields of the GraphQL type Edge.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetCondition added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetCondition() *json.RawMessage

GetCondition returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.Condition, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetDescription added in v0.3.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetDescription() *string

GetDescription returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.Description, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetId added in v0.9.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetId() string

GetId returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.Id, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetIsRunnable added in v0.3.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetIsRunnable() *bool

GetIsRunnable returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.IsRunnable, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetLoc added in v0.3.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetLoc() string

GetLoc returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.Loc, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetName added in v0.3.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetName() *string

GetName returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.Name, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetPriority added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetPriority() int

GetPriority returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.Priority, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetTarget added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge) GetTarget() *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode

GetTarget returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdge.Target, and is useful for accessing the field via an interface.

type NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode added in v0.2.0 

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

NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode includes the requested fields of the GraphQL type Node.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode) GetId added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode) GetId() string

GetId returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode.Id, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode) GetLoc added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode) GetLoc() string

GetLoc returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode.Loc, and is useful for accessing the field via an interface.

func (*NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode) GetMemoryId added in v0.2.0 

func (v *NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode) GetMemoryId() string

GetMemoryId returns NodeBatchNodeBatchNodeBatchResultNodesNodeOutgoingEdgesEdgeTargetNode.MemoryId, and is useful for accessing the field via an interface.

type NodeBatchResponse added in v0.2.0 

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 node(ref:) per node (e.g. 'spec lint --all'). Provide EITHER
	// 'refs' (explicit set, returned in input order) OR 'memory' + 'locPrefix'
	// (subtree, loc order) — not both. Each entry of 'refs' is a primary key OR a
	// fully-qualified node URN (cor:api:140), so a URN-holding caller batches in
	// ONE call instead of resolving each ref first. The split on a bad ref is by
	// KIND, not by luck: a ref whose SHAPE is wrong errors the call — unqualified
	// / relative (UrnNotQualifiedError) or a URN of the wrong entity type, e.g.
	// 'hrn:mem:...' (BAD_USER_INPUT) — while a well-formed ref that names nothing
	// the caller may read comes back in 'unavailable'. A caller mistake stays
	// loud instead of hiding among denials. Per-node access is applied
	// independently AFTER resolution: denied or missing refs 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 refs in 'omitted'
	// (never a silent short read). Node content is returned raw — Mustache
	// templates are NOT compiled (unlike the single-node 'node' read), 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"`
}

NodeBatchResponse is returned by NodeBatch on success.

func NodeBatch added in v0.2.0 

func NodeBatch(
	ctx_ context.Context,
	client_ graphql.Client,
	refs []string,
	memory *string,
	locPrefix *string,
) (data_ *NodeBatchResponse, err_ error)

Bulk read of full nodes by ref (cor:api:040). Each entry of `refs` is a primary key OR a fully-qualified node URN (hadron-server#813) — so a caller holding URNs reads them in ONE call instead of resolving each one first. A malformed ref is a loud server error, so refs are validated client-side before they go out. Server caps a call at 200 nodes / 1 MB: an over-cap window comes back with truncated=true and the spillover in `omitted`, so callers must re-request those; `unavailable` lists refs the server could not return (deleted/inaccessible). Both lists echo the refs as SENT. Selects a full node projection — both edge directions (with target/source loc + memoryId), everything the markdown exporter serializes, and the fields the spec detail/ lint builders read — so the whole-corpus fan-outs (`memory export`, `spec get --prefix`) read in ceil(N/200) round-trips instead of one node(ref) per node. Driven through api.CollectNodeBatch. The prefix form (memory + locPrefix) reads a whole subtree in ONE call with no per-node resolution, which `node get --prefix` uses. The server requires EITHER refs OR memory+locPrefix, so every variable is omitempty: a nil pointer must be absent, not an explicit null the server would count as "provided".

func (*NodeBatchResponse) GetNodeBatch added in v0.2.0 

func (v *NodeBatchResponse) GetNodeBatch() *NodeBatchNodeBatchNodeBatchResult

GetNodeBatch returns NodeBatchResponse.NodeBatch, and is useful for accessing the field via an interface.

type NodeContentValidationFields added in v0.19.0 

type NodeContentValidationFields struct {
	State        NodeContentValidationState                                          `json:"state"`
	LatestReport *NodeContentValidationFieldsLatestReportNodeContentValidationReport `json:"latestReport"`
}

#1326 — advisory validation. `state` is for THIS revision: a report made for an older revision reads STALE, and latestReport says which revision it was.

func (*NodeContentValidationFields) GetLatestReport added in v0.19.0 

func (v *NodeContentValidationFields) GetLatestReport() *NodeContentValidationFieldsLatestReportNodeContentValidationReport

GetLatestReport returns NodeContentValidationFields.LatestReport, and is useful for accessing the field via an interface.

func (*NodeContentValidationFields) GetState added in v0.19.0 

func (v *NodeContentValidationFields) GetState() NodeContentValidationState

GetState returns NodeContentValidationFields.State, and is useful for accessing the field via an interface.

type NodeContentValidationFieldsLatestReportNodeContentValidationReport added in v0.19.0 

type NodeContentValidationFieldsLatestReportNodeContentValidationReport struct {
	Outcome                NodeContentValidationOutcome `json:"outcome"`
	NodeRevision           int                          `json:"nodeRevision"`
	ReportedAt             string                       `json:"reportedAt"`
	ValidationTaskRef      *string                      `json:"validationTaskRef"`
	ValidationTaskRevision *int                         `json:"validationTaskRevision"`
}

NodeContentValidationFieldsLatestReportNodeContentValidationReport includes the requested fields of the GraphQL type NodeContentValidationReport.

func (*NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetNodeRevision added in v0.19.0 

func (v *NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetNodeRevision() int

GetNodeRevision returns NodeContentValidationFieldsLatestReportNodeContentValidationReport.NodeRevision, and is useful for accessing the field via an interface.

func (*NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetOutcome added in v0.19.0 

func (v *NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetOutcome() NodeContentValidationOutcome

GetOutcome returns NodeContentValidationFieldsLatestReportNodeContentValidationReport.Outcome, and is useful for accessing the field via an interface.

func (*NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetReportedAt added in v0.19.0 

func (v *NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetReportedAt() string

GetReportedAt returns NodeContentValidationFieldsLatestReportNodeContentValidationReport.ReportedAt, and is useful for accessing the field via an interface.

func (*NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetValidationTaskRef added in v0.19.0 

func (v *NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetValidationTaskRef() *string

GetValidationTaskRef returns NodeContentValidationFieldsLatestReportNodeContentValidationReport.ValidationTaskRef, and is useful for accessing the field via an interface.

func (*NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetValidationTaskRevision added in v0.19.0 

func (v *NodeContentValidationFieldsLatestReportNodeContentValidationReport) GetValidationTaskRevision() *int

GetValidationTaskRevision returns NodeContentValidationFieldsLatestReportNodeContentValidationReport.ValidationTaskRevision, and is useful for accessing the field via an interface.

type NodeContentValidationOutcome added in v0.19.0 

type NodeContentValidationOutcome string
const (
	NodeContentValidationOutcomeError NodeContentValidationOutcome = "ERROR"
	NodeContentValidationOutcomeFail  NodeContentValidationOutcome = "FAIL"
	NodeContentValidationOutcomePass  NodeContentValidationOutcome = "PASS"
)

type NodeContentValidationState added in v0.19.0 

type NodeContentValidationState string
const (
	NodeContentValidationStateError       NodeContentValidationState = "ERROR"
	NodeContentValidationStateFail        NodeContentValidationState = "FAIL"
	NodeContentValidationStatePass        NodeContentValidationState = "PASS"
	NodeContentValidationStateStale       NodeContentValidationState = "STALE"
	NodeContentValidationStateUnvalidated NodeContentValidationState = "UNVALIDATED"
)

type NodeEdgeInput 

type NodeEdgeInput struct {
	Description *string `json:"description"`
	IsRunnable  *bool   `json:"isRunnable"`
	// Explicit edge loc. Omit to derive <sourceLoc>:<name>:<targetLoc>.
	Loc *string `json:"loc"`
	// Relationship name (was 'label'). Optional — loc is the identity.
	Name *string `json:"name"`
	// 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"`
}

Outgoing edge on a node, used in NodeInput.edges

func (*NodeEdgeInput) GetDescription added in v0.3.0 

func (v *NodeEdgeInput) GetDescription() *string

GetDescription returns NodeEdgeInput.Description, and is useful for accessing the field via an interface.

func (*NodeEdgeInput) GetIsRunnable added in v0.3.0 

func (v *NodeEdgeInput) GetIsRunnable() *bool

GetIsRunnable returns NodeEdgeInput.IsRunnable, and is useful for accessing the field via an interface.

func (*NodeEdgeInput) GetLoc added in v0.3.0 

func (v *NodeEdgeInput) GetLoc() *string

GetLoc returns NodeEdgeInput.Loc, and is useful for accessing the field via an interface.

func (*NodeEdgeInput) GetName added in v0.3.0 

func (v *NodeEdgeInput) GetName() *string

GetName returns NodeEdgeInput.Name, and is useful for accessing the field via an interface.

func (*NodeEdgeInput) GetTargetId 

func (v *NodeEdgeInput) GetTargetId() string

GetTargetId returns NodeEdgeInput.TargetId, and is useful for accessing the field via an interface.

type NodeExportFormat added in v0.4.0 

type NodeExportFormat string

Single-node export (#386). MD/JSON are the canonical, round-trippable files; PDF is a presentation render (content only) produced by the internal hadrontool-pdf service and delivered BASE64. HTML remains reserved. 

const (
	NodeExportFormatJson NodeExportFormat = "JSON"
	NodeExportFormatMd   NodeExportFormat = "MD"
	NodeExportFormatPdf  NodeExportFormat = "PDF"
)

type NodeExportMetaNode added in v0.5.1 

type NodeExportMetaNode struct {
	Loc      string                    `json:"loc"`
	Name     string                    `json:"name"`
	MemoryId string                    `json:"memoryId"`
	Memory   *NodeExportMetaNodeMemory `json:"memory"`
}

NodeExportMetaNode includes the requested fields of the GraphQL type Node.

func (*NodeExportMetaNode) GetLoc added in v0.5.1 

func (v *NodeExportMetaNode) GetLoc() string

GetLoc returns NodeExportMetaNode.Loc, and is useful for accessing the field via an interface.

func (*NodeExportMetaNode) GetMemory added in v0.5.1 

func (v *NodeExportMetaNode) GetMemory() *NodeExportMetaNodeMemory

GetMemory returns NodeExportMetaNode.Memory, and is useful for accessing the field via an interface.

func (*NodeExportMetaNode) GetMemoryId added in v0.5.1 

func (v *NodeExportMetaNode) GetMemoryId() string

GetMemoryId returns NodeExportMetaNode.MemoryId, and is useful for accessing the field via an interface.

func (*NodeExportMetaNode) GetName added in v0.5.1 

func (v *NodeExportMetaNode) GetName() string

GetName returns NodeExportMetaNode.Name, and is useful for accessing the field via an interface.

type NodeExportMetaNodeMemory added in v0.5.1 

type NodeExportMetaNodeMemory struct {
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn string `json:"urn"`
}

NodeExportMetaNodeMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*NodeExportMetaNodeMemory) GetUrn added in v0.5.1 

func (v *NodeExportMetaNodeMemory) GetUrn() string

GetUrn returns NodeExportMetaNodeMemory.Urn, and is useful for accessing the field via an interface.

type NodeExportMetaResponse added in v0.4.0 

type NodeExportMetaResponse struct {
	// The uniform single-node read (#473) — subsumes the former nodeById(id:)
	// and node(loc:, memory:) split. 'ref' accepts, in dispatch order:
	//
	// 1. a primary key (the unambiguous read — the old nodeById),
	// 2. a fully-qualified node URN (`hrn:node:<root>:<memory>:<loc>`,
	// legacy `urn:` scheme accepted),
	// 3. a bare loc — scoped by 'memoryRef' (an ID or URN) when given; unscoped,
	// it resolves across every readable memory and a cross-memory loc
	// collision is REJECTED with extensions.code AMBIGUOUS_NODE_LOC
	// (listing the candidate memoryIds) rather than silently returning
	// one (#335). An unprefixed 3+-segment ref whose first two segments
	// name a readable memory is treated as form 2 (a full URN); pass
	// 'memoryRef' to force loc interpretation.
	//
	// raw: true skips Mustache template compilation. Soft-deleted nodes do not
	// resolve. Access: the caller's readable-memory set (same gate the old
	// queries used); denied and missing are both null.
	Node *NodeExportMetaNode `json:"node"`
}

NodeExportMetaResponse is returned by NodeExportMeta on success.

func NodeExportMeta added in v0.4.0 

func NodeExportMeta(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *NodeExportMetaResponse, err_ error)

Minimal metadata for the `node export -o` summary (loc/name/memory): the server's nodeExport render returns the bytes but no identifying fields, and memory { urn } here avoids a second memory-list round-trip (#106 review).

func (*NodeExportMetaResponse) GetNode added in v0.5.1 

func (v *NodeExportMetaResponse) GetNode() *NodeExportMetaNode

GetNode returns NodeExportMetaResponse.Node, and is useful for accessing the field via an interface.

type NodeExportNodeExportNodeExportResult added in v0.4.0 

type NodeExportNodeExportNodeExportResult struct {
	Format NodeExportFormat `json:"format"`
	// MIME type, e.g. text/markdown or application/json.
	MimeType string `json:"mimeType"`
	// Suggested download filename, e.g. <loc-leaf>.md.
	Filename string `json:"filename"`
	// The rendered file contents (TEXT).
	Data string `json:"data"`
	// Byte length of the rendered payload (UTF-8).
	Bytes int `json:"bytes"`
}

NodeExportNodeExportNodeExportResult includes the requested fields of the GraphQL type NodeExportResult.

func (*NodeExportNodeExportNodeExportResult) GetBytes added in v0.4.0 

func (v *NodeExportNodeExportNodeExportResult) GetBytes() int

GetBytes returns NodeExportNodeExportNodeExportResult.Bytes, and is useful for accessing the field via an interface.

func (*NodeExportNodeExportNodeExportResult) GetData added in v0.4.0 

func (v *NodeExportNodeExportNodeExportResult) GetData() string

GetData returns NodeExportNodeExportNodeExportResult.Data, and is useful for accessing the field via an interface.

func (*NodeExportNodeExportNodeExportResult) GetFilename added in v0.4.0 

func (v *NodeExportNodeExportNodeExportResult) GetFilename() string

GetFilename returns NodeExportNodeExportNodeExportResult.Filename, and is useful for accessing the field via an interface.

func (*NodeExportNodeExportNodeExportResult) GetFormat added in v0.4.0 

func (v *NodeExportNodeExportNodeExportResult) GetFormat() NodeExportFormat

GetFormat returns NodeExportNodeExportNodeExportResult.Format, and is useful for accessing the field via an interface.

func (*NodeExportNodeExportNodeExportResult) GetMimeType added in v0.4.0 

func (v *NodeExportNodeExportNodeExportResult) GetMimeType() string

GetMimeType returns NodeExportNodeExportNodeExportResult.MimeType, and is useful for accessing the field via an interface.

type NodeExportResponse added in v0.4.0 

type NodeExportResponse struct {
	// Render one node to a portable, self-contained file (spec cor:api).
	// full: true (default) returns the CANONICAL form — byte-identical to
	// "hadron node export <urn>", all sections, round-trippable via
	// "hadron node import". Requires MD or JSON; sections is ignored.
	// full: false returns a PRESENTATION render of the selected sections
	// (default: all); not guaranteed round-trippable.
	// Auth: same node-read gate as node(ref:). (HTML/PDF + asUrl delivery land
	// later; the result shape is forward-compatible.)
	NodeExport *NodeExportNodeExportNodeExportResult `json:"nodeExport"`
}

NodeExportResponse is returned by NodeExport on success.

func NodeExport added in v0.4.0 

func NodeExport(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	format NodeExportFormat,
) (data_ *NodeExportResponse, err_ error)

Render one node to its canonical, round-trippable file via the SERVER's renderer (#106) — so `hadron node export` emits byte-for-byte what the portal and every other API client get from the one shared renderer. full: true is the canonical form (all sections, importable); format selects MD or JSON.

func (*NodeExportResponse) GetNodeExport added in v0.4.0 

func (v *NodeExportResponse) GetNodeExport() *NodeExportNodeExportNodeExportResult

GetNodeExport returns NodeExportResponse.NodeExport, and is useful for accessing the field via an interface.

type NodeFilter added in v0.5.0 

type NodeFilter struct {
	// #1591 — only nodes in this approval state (read from the stored revision; a node changed outside a revisioned writer is reconciled on its next read).
	ApprovalState *NodeApprovalState `json:"approvalState,omitempty"`
	CreatedBy     *string            `json:"createdBy,omitempty"`
	// Include soft-deleted nodes (default false).
	IncludeDeleted *bool   `json:"includeDeleted,omitempty"`
	IsRunnable     *bool   `json:"isRunnable,omitempty"`
	LocPrefix      *string `json:"locPrefix,omitempty"`
	// Restrict by memory class. SYSTEM is excluded by default; passing this (or naming a system memory in memoryIds) overrides that.
	MemoryClasses []MemoryClass `json:"memoryClasses,omitempty"`
	// Memory scope — a mix of memory IDs and fully-qualified URNs; intersected with the caller's access.
	MemoryIds []string `json:"memoryIds,omitempty"`
	// #1591 — only minted (true) or unminted (false) nodes.
	Minted   *bool   `json:"minted,omitempty"`
	NodeType *string `json:"nodeType,omitempty"`
	// #725 — collection facet: only nodes whose objectType equals this (e.g. "competitor").
	ObjectType *string `json:"objectType,omitempty"`
	// #1322 — role-family filter. 'spec' matches 'spec' and 'spec.*' on a dot boundary, never 'special' / 'specification'.
	Role          *string  `json:"role,omitempty"`
	Tags          []string `json:"tags,omitempty"`
	UpdatedAfter  *string  `json:"updatedAfter,omitempty"`
	UpdatedBefore *string  `json:"updatedBefore,omitempty"`
	// Structured predicate over the node's properties/data JSONB (#719).
	Where *gqltypes.NodeWhereInput `json:"where,omitempty"`
}

Structured, unscored, AND-combined filter context for findNodes (cor:api:090:02).

func (*NodeFilter) GetApprovalState added in v0.19.0 

func (v *NodeFilter) GetApprovalState() *NodeApprovalState

GetApprovalState returns NodeFilter.ApprovalState, and is useful for accessing the field via an interface.

func (*NodeFilter) GetCreatedBy added in v0.5.0 

func (v *NodeFilter) GetCreatedBy() *string

GetCreatedBy returns NodeFilter.CreatedBy, and is useful for accessing the field via an interface.

func (*NodeFilter) GetIncludeDeleted added in v0.5.0 

func (v *NodeFilter) GetIncludeDeleted() *bool

GetIncludeDeleted returns NodeFilter.IncludeDeleted, and is useful for accessing the field via an interface.

func (*NodeFilter) GetIsRunnable added in v0.5.0 

func (v *NodeFilter) GetIsRunnable() *bool

GetIsRunnable returns NodeFilter.IsRunnable, and is useful for accessing the field via an interface.

func (*NodeFilter) GetLocPrefix added in v0.5.0 

func (v *NodeFilter) GetLocPrefix() *string

GetLocPrefix returns NodeFilter.LocPrefix, and is useful for accessing the field via an interface.

func (*NodeFilter) GetMemoryClasses added in v0.5.0 

func (v *NodeFilter) GetMemoryClasses() []MemoryClass

GetMemoryClasses returns NodeFilter.MemoryClasses, and is useful for accessing the field via an interface.

func (*NodeFilter) GetMemoryIds added in v0.5.0 

func (v *NodeFilter) GetMemoryIds() []string

GetMemoryIds returns NodeFilter.MemoryIds, and is useful for accessing the field via an interface.

func (*NodeFilter) GetMinted added in v0.19.0 

func (v *NodeFilter) GetMinted() *bool

GetMinted returns NodeFilter.Minted, and is useful for accessing the field via an interface.

func (*NodeFilter) GetNodeType added in v0.5.0 

func (v *NodeFilter) GetNodeType() *string

GetNodeType returns NodeFilter.NodeType, and is useful for accessing the field via an interface.

func (*NodeFilter) GetObjectType added in v0.8.0 

func (v *NodeFilter) GetObjectType() *string

GetObjectType returns NodeFilter.ObjectType, and is useful for accessing the field via an interface.

func (*NodeFilter) GetRole added in v0.18.0 

func (v *NodeFilter) GetRole() *string

GetRole returns NodeFilter.Role, and is useful for accessing the field via an interface.

func (*NodeFilter) GetTags added in v0.5.0 

func (v *NodeFilter) GetTags() []string

GetTags returns NodeFilter.Tags, and is useful for accessing the field via an interface.

func (*NodeFilter) GetUpdatedAfter added in v0.5.0 

func (v *NodeFilter) GetUpdatedAfter() *string

GetUpdatedAfter returns NodeFilter.UpdatedAfter, and is useful for accessing the field via an interface.

func (*NodeFilter) GetUpdatedBefore added in v0.5.0 

func (v *NodeFilter) GetUpdatedBefore() *string

GetUpdatedBefore returns NodeFilter.UpdatedBefore, and is useful for accessing the field via an interface.

func (*NodeFilter) GetWhere added in v0.8.0 

func (v *NodeFilter) GetWhere() *gqltypes.NodeWhereInput

GetWhere returns NodeFilter.Where, and is useful for accessing the field via an interface.

type NodeIntegrityState added in v0.19.0 

type NodeIntegrityState string

#1591 — the tamper check's verdict. 

const (
	// The current revision is approved and its text still hashes to the approval.
	NodeIntegrityStateIntact NodeIntegrityState = "INTACT"
	// Never approved: nothing to verify against.
	NodeIntegrityStateNotApproved NodeIntegrityState = "NOT_APPROVED"
	// Edited (a new revision) since the last approval. Not a tamper finding.
	NodeIntegrityStateSuperseded NodeIntegrityState = "SUPERSEDED"
	// Approved text no longer hashes to its approval: it changed outside the revision system.
	NodeIntegrityStateTampered NodeIntegrityState = "TAMPERED"
)

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResult added in v0.19.0 

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

NodeLiveRevisionsApprovedNodeBatchNodeBatchResult includes the requested fields of the GraphQL type NodeBatchResult. The GraphQL type's documentation follows.

Spec cor:api:040 — result envelope for the batch node read (nodeBatch). 'nodes' is the authorized, existing subset (input order for a ref set, loc order for a prefix). 'unavailable' and 'omitted' are both lists of REFS, not node objects. 'unavailable' lists the requested refs that were denied OR not found — indistinguishable, so the result never discloses whether an unreadable node exists. 'truncated' is true when the response-size cap was reached, and 'omitted' then carries the refs of the nodes dropped to stay under it. (Over the node-count cap the query errors instead — never a silent short read.) Both lists echo the caller's OWN ref strings for the 'refs' form — pass a URN, get that URN back, not a primary key you never sent — and node ids for the prefix form, which has no caller refs.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetNodes added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetNodes() []*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode

GetNodes returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResult.Nodes, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetOmitted added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetOmitted() []string

GetOmitted returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResult.Omitted, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetTruncated added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetTruncated() bool

GetTruncated returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResult.Truncated, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetUnavailable added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResult) GetUnavailable() []string

GetUnavailable returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResult.Unavailable, and is useful for accessing the field via an interface.

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode added in v0.19.0 

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode struct {
	Id string `json:"id"`
	// #1323 — current live revision. Creation is revision 1; each committed authoring change advances it. NodeRevision.revNo N is the retained snapshot of this node when revision N was current, before the edit that advanced it.
	Revision int `json:"revision"`
	// #1326 — attribution of this content state. Null means legacy or unknown. Task identity is redacted unless its memory is independently readable.
	Authorship *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship `json:"authorship"`
	// #1326 — advisory validation for this exact revision. A report for an older revision is STALE.
	ContentValidation *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus `json:"contentValidation"`
	// #1591 — whether the current revision is approved, and the latest approval on record.
	ApprovalStatus *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus `json:"approvalStatus"`
}

NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode includes the requested fields of the GraphQL type Node.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetApprovalStatus added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetApprovalStatus() *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus

GetApprovalStatus returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode.ApprovalStatus, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetAuthorship added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetAuthorship() *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship

GetAuthorship returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode.Authorship, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetContentValidation added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetContentValidation() *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus

GetContentValidation returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode.ContentValidation, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetId added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetId() string

GetId returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode.Id, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetRevision added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode) GetRevision() int

GetRevision returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNode.Revision, and is useful for accessing the field via an interface.

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus added in v0.19.0 

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus struct {
	NodeApprovalStatusFields `json:"-"`
}

NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus includes the requested fields of the GraphQL type NodeApprovalStatus. The GraphQL type's documentation follows.

#1591 — a node's approval state plus its latest approval.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetApproval added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetApproval() *NodeApprovalStatusFieldsApprovalNodeApproval

GetApproval returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus.Approval, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetState added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetState() NodeApprovalState

GetState returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus.State, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeApprovalStatus) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship added in v0.19.0 

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship struct {
	NodeAuthorshipFields `json:"-"`
}

NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship includes the requested fields of the GraphQL type NodeAuthorship.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetAuthoredAt added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetAuthoredAt() string

GetAuthoredAt returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship.AuthoredAt, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetHuman added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetHuman() *NodeAuthorshipFieldsHumanNodeRevisionEditor

GetHuman returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship.Human, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetKind added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetKind() NodeAuthorshipKind

GetKind returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship.Kind, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRef added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRef() *string

GetTaskRef returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship.TaskRef, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRevision added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRevision() *int

GetTaskRevision returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship.TaskRevision, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeAuthorship) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus added in v0.19.0 

type NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus struct {
	NodeContentValidationFields `json:"-"`
}

NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus includes the requested fields of the GraphQL type NodeContentValidationStatus.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetLatestReport added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetLatestReport() *NodeContentValidationFieldsLatestReportNodeContentValidationReport

GetLatestReport returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus.LatestReport, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetState added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetState() NodeContentValidationState

GetState returns NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus.State, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsApprovedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsApprovedResponse added in v0.19.0 

type NodeLiveRevisionsApprovedResponse 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 node(ref:) per node (e.g. 'spec lint --all'). Provide EITHER
	// 'refs' (explicit set, returned in input order) OR 'memory' + 'locPrefix'
	// (subtree, loc order) — not both. Each entry of 'refs' is a primary key OR a
	// fully-qualified node URN (cor:api:140), so a URN-holding caller batches in
	// ONE call instead of resolving each ref first. The split on a bad ref is by
	// KIND, not by luck: a ref whose SHAPE is wrong errors the call — unqualified
	// / relative (UrnNotQualifiedError) or a URN of the wrong entity type, e.g.
	// 'hrn:mem:...' (BAD_USER_INPUT) — while a well-formed ref that names nothing
	// the caller may read comes back in 'unavailable'. A caller mistake stays
	// loud instead of hiding among denials. Per-node access is applied
	// independently AFTER resolution: denied or missing refs 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 refs in 'omitted'
	// (never a silent short read). Node content is returned raw — Mustache
	// templates are NOT compiled (unlike the single-node 'node' read), since this
	// is a bulk source read for lint / audit / migration and compiling per node
	// would re-introduce the N+1 it eliminates.
	NodeBatch *NodeLiveRevisionsApprovedNodeBatchNodeBatchResult `json:"nodeBatch"`
}

NodeLiveRevisionsApprovedResponse is returned by NodeLiveRevisionsApproved on success.

func NodeLiveRevisionsApproved added in v0.19.0 

func NodeLiveRevisionsApproved(
	ctx_ context.Context,
	client_ graphql.Client,
	refs []string,
	memory *string,
	locPrefix *string,
) (data_ *NodeLiveRevisionsApprovedResponse, err_ error)

`node get` uses this in its before/after revision bracket. The AFTER result supplies the approval because it may change without advancing the revision. Spec reads can use it in 200-node windows to attach status without N+1 reads.

func (*NodeLiveRevisionsApprovedResponse) GetNodeBatch added in v0.19.0 

func (v *NodeLiveRevisionsApprovedResponse) GetNodeBatch() *NodeLiveRevisionsApprovedNodeBatchNodeBatchResult

GetNodeBatch returns NodeLiveRevisionsApprovedResponse.NodeBatch, and is useful for accessing the field via an interface.

type NodeLiveRevisionsMintedNodeBatchNodeBatchResult added in v0.19.0 

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

NodeLiveRevisionsMintedNodeBatchNodeBatchResult includes the requested fields of the GraphQL type NodeBatchResult. The GraphQL type's documentation follows.

Spec cor:api:040 — result envelope for the batch node read (nodeBatch). 'nodes' is the authorized, existing subset (input order for a ref set, loc order for a prefix). 'unavailable' and 'omitted' are both lists of REFS, not node objects. 'unavailable' lists the requested refs that were denied OR not found — indistinguishable, so the result never discloses whether an unreadable node exists. 'truncated' is true when the response-size cap was reached, and 'omitted' then carries the refs of the nodes dropped to stay under it. (Over the node-count cap the query errors instead — never a silent short read.) Both lists echo the caller's OWN ref strings for the 'refs' form — pass a URN, get that URN back, not a primary key you never sent — and node ids for the prefix form, which has no caller refs.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetNodes added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetNodes() []*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode

GetNodes returns NodeLiveRevisionsMintedNodeBatchNodeBatchResult.Nodes, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetOmitted added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetOmitted() []string

GetOmitted returns NodeLiveRevisionsMintedNodeBatchNodeBatchResult.Omitted, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetTruncated added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetTruncated() bool

GetTruncated returns NodeLiveRevisionsMintedNodeBatchNodeBatchResult.Truncated, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetUnavailable added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResult) GetUnavailable() []string

GetUnavailable returns NodeLiveRevisionsMintedNodeBatchNodeBatchResult.Unavailable, and is useful for accessing the field via an interface.

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode added in v0.19.0 

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode struct {
	Id string `json:"id"`
	// #1323 — current live revision. Creation is revision 1; each committed authoring change advances it. NodeRevision.revNo N is the retained snapshot of this node when revision N was current, before the edit that advanced it.
	Revision int `json:"revision"`
	// #1326 — attribution of this content state. Null means legacy or unknown. Task identity is redacted unless its memory is independently readable.
	Authorship *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship `json:"authorship"`
	// #1326 — advisory validation for this exact revision. A report for an older revision is STALE.
	ContentValidation *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus `json:"contentValidation"`
	// #1591 — whether the current revision is approved, and the latest approval on record.
	ApprovalStatus *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus `json:"approvalStatus"`
	// #1591 — whether this node is minted, and the record of it.
	MintStatus *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus `json:"mintStatus"`
}

NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode includes the requested fields of the GraphQL type Node.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetApprovalStatus added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetApprovalStatus() *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus

GetApprovalStatus returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode.ApprovalStatus, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetAuthorship added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetAuthorship() *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship

GetAuthorship returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode.Authorship, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetContentValidation added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetContentValidation() *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus

GetContentValidation returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode.ContentValidation, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetId added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetId() string

GetId returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode.Id, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetMintStatus added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetMintStatus() *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus

GetMintStatus returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode.MintStatus, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetRevision added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode) GetRevision() int

GetRevision returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNode.Revision, and is useful for accessing the field via an interface.

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus added in v0.19.0 

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus struct {
	NodeApprovalStatusFields `json:"-"`
}

NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus includes the requested fields of the GraphQL type NodeApprovalStatus. The GraphQL type's documentation follows.

#1591 — a node's approval state plus its latest approval.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetApproval added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetApproval() *NodeApprovalStatusFieldsApprovalNodeApproval

GetApproval returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus.Approval, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetState added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) GetState() NodeApprovalState

GetState returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus.State, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeApprovalStatus) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship added in v0.19.0 

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship struct {
	NodeAuthorshipFields `json:"-"`
}

NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship includes the requested fields of the GraphQL type NodeAuthorship.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetAuthoredAt added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetAuthoredAt() string

GetAuthoredAt returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship.AuthoredAt, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetHuman added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetHuman() *NodeAuthorshipFieldsHumanNodeRevisionEditor

GetHuman returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship.Human, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetKind added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetKind() NodeAuthorshipKind

GetKind returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship.Kind, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRef added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRef() *string

GetTaskRef returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship.TaskRef, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRevision added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRevision() *int

GetTaskRevision returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship.TaskRevision, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeAuthorship) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus added in v0.19.0 

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus struct {
	NodeContentValidationFields `json:"-"`
}

NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus includes the requested fields of the GraphQL type NodeContentValidationStatus.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetLatestReport added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetLatestReport() *NodeContentValidationFieldsLatestReportNodeContentValidationReport

GetLatestReport returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus.LatestReport, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetState added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetState() NodeContentValidationState

GetState returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus.State, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus added in v0.19.0 

type NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus struct {
	NodeMintStatusFields `json:"-"`
}

NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus includes the requested fields of the GraphQL type NodeMintStatus. The GraphQL type's documentation follows.

#1591 — whether a node is minted, and the record of it. Minting protects nothing by itself (permanence is off for now).

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetHash added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetHash() *string

GetHash returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus.Hash, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMinted added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMinted() bool

GetMinted returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus.Minted, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMintedAt added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMintedAt() *string

GetMintedAt returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus.MintedAt, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMintedBy added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMintedBy() *NodeMintStatusFieldsMintedByNodeRevisionEditor

GetMintedBy returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus.MintedBy, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMintedByInfo added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetMintedByInfo() *string

GetMintedByInfo returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus.MintedByInfo, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetRevision added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) GetRevision() *int

GetRevision returns NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus.Revision, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsMintedNodeBatchNodeBatchResultNodesNodeMintStatus) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsMintedResponse added in v0.19.0 

type NodeLiveRevisionsMintedResponse 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 node(ref:) per node (e.g. 'spec lint --all'). Provide EITHER
	// 'refs' (explicit set, returned in input order) OR 'memory' + 'locPrefix'
	// (subtree, loc order) — not both. Each entry of 'refs' is a primary key OR a
	// fully-qualified node URN (cor:api:140), so a URN-holding caller batches in
	// ONE call instead of resolving each ref first. The split on a bad ref is by
	// KIND, not by luck: a ref whose SHAPE is wrong errors the call — unqualified
	// / relative (UrnNotQualifiedError) or a URN of the wrong entity type, e.g.
	// 'hrn:mem:...' (BAD_USER_INPUT) — while a well-formed ref that names nothing
	// the caller may read comes back in 'unavailable'. A caller mistake stays
	// loud instead of hiding among denials. Per-node access is applied
	// independently AFTER resolution: denied or missing refs 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 refs in 'omitted'
	// (never a silent short read). Node content is returned raw — Mustache
	// templates are NOT compiled (unlike the single-node 'node' read), since this
	// is a bulk source read for lint / audit / migration and compiling per node
	// would re-introduce the N+1 it eliminates.
	NodeBatch *NodeLiveRevisionsMintedNodeBatchNodeBatchResult `json:"nodeBatch"`
}

NodeLiveRevisionsMintedResponse is returned by NodeLiveRevisionsMinted on success.

func NodeLiveRevisionsMinted added in v0.19.0 

func NodeLiveRevisionsMinted(
	ctx_ context.Context,
	client_ graphql.Client,
	refs []string,
	memory *string,
	locPrefix *string,
) (data_ *NodeLiveRevisionsMintedResponse, err_ error)

PR 2 adds mintStatus. Keep a distinct operation so a PR 1 server can still answer NodeLiveRevisionsApproved without losing approval or revisions.

func (*NodeLiveRevisionsMintedResponse) GetNodeBatch added in v0.19.0 

func (v *NodeLiveRevisionsMintedResponse) GetNodeBatch() *NodeLiveRevisionsMintedNodeBatchNodeBatchResult

GetNodeBatch returns NodeLiveRevisionsMintedResponse.NodeBatch, and is useful for accessing the field via an interface.

type NodeLiveRevisionsNodeBatchNodeBatchResult added in v0.18.0 

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

NodeLiveRevisionsNodeBatchNodeBatchResult includes the requested fields of the GraphQL type NodeBatchResult. The GraphQL type's documentation follows.

Spec cor:api:040 — result envelope for the batch node read (nodeBatch). 'nodes' is the authorized, existing subset (input order for a ref set, loc order for a prefix). 'unavailable' and 'omitted' are both lists of REFS, not node objects. 'unavailable' lists the requested refs that were denied OR not found — indistinguishable, so the result never discloses whether an unreadable node exists. 'truncated' is true when the response-size cap was reached, and 'omitted' then carries the refs of the nodes dropped to stay under it. (Over the node-count cap the query errors instead — never a silent short read.) Both lists echo the caller's OWN ref strings for the 'refs' form — pass a URN, get that URN back, not a primary key you never sent — and node ids for the prefix form, which has no caller refs.

func (*NodeLiveRevisionsNodeBatchNodeBatchResult) GetNodes added in v0.18.0 

func (v *NodeLiveRevisionsNodeBatchNodeBatchResult) GetNodes() []*NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode

GetNodes returns NodeLiveRevisionsNodeBatchNodeBatchResult.Nodes, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsNodeBatchNodeBatchResult) GetOmitted added in v0.18.0 

func (v *NodeLiveRevisionsNodeBatchNodeBatchResult) GetOmitted() []string

GetOmitted returns NodeLiveRevisionsNodeBatchNodeBatchResult.Omitted, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsNodeBatchNodeBatchResult) GetTruncated added in v0.18.0 

func (v *NodeLiveRevisionsNodeBatchNodeBatchResult) GetTruncated() bool

GetTruncated returns NodeLiveRevisionsNodeBatchNodeBatchResult.Truncated, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsNodeBatchNodeBatchResult) GetUnavailable added in v0.18.0 

func (v *NodeLiveRevisionsNodeBatchNodeBatchResult) GetUnavailable() []string

GetUnavailable returns NodeLiveRevisionsNodeBatchNodeBatchResult.Unavailable, and is useful for accessing the field via an interface.

type NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode added in v0.18.0 

type NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode struct {
	Id string `json:"id"`
	// #1323 — current live revision. Creation is revision 1; each committed authoring change advances it. NodeRevision.revNo N is the retained snapshot of this node when revision N was current, before the edit that advanced it.
	Revision int `json:"revision"`
}

NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode includes the requested fields of the GraphQL type Node.

func (*NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode) GetId added in v0.18.0 

func (v *NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode) GetId() string

GetId returns NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode.Id, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode) GetRevision added in v0.18.0 

func (v *NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode) GetRevision() int

GetRevision returns NodeLiveRevisionsNodeBatchNodeBatchResultNodesNode.Revision, and is useful for accessing the field via an interface.

type NodeLiveRevisionsResponse added in v0.18.0 

type NodeLiveRevisionsResponse 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 node(ref:) per node (e.g. 'spec lint --all'). Provide EITHER
	// 'refs' (explicit set, returned in input order) OR 'memory' + 'locPrefix'
	// (subtree, loc order) — not both. Each entry of 'refs' is a primary key OR a
	// fully-qualified node URN (cor:api:140), so a URN-holding caller batches in
	// ONE call instead of resolving each ref first. The split on a bad ref is by
	// KIND, not by luck: a ref whose SHAPE is wrong errors the call — unqualified
	// / relative (UrnNotQualifiedError) or a URN of the wrong entity type, e.g.
	// 'hrn:mem:...' (BAD_USER_INPUT) — while a well-formed ref that names nothing
	// the caller may read comes back in 'unavailable'. A caller mistake stays
	// loud instead of hiding among denials. Per-node access is applied
	// independently AFTER resolution: denied or missing refs 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 refs in 'omitted'
	// (never a silent short read). Node content is returned raw — Mustache
	// templates are NOT compiled (unlike the single-node 'node' read), since this
	// is a bulk source read for lint / audit / migration and compiling per node
	// would re-introduce the N+1 it eliminates.
	NodeBatch *NodeLiveRevisionsNodeBatchNodeBatchResult `json:"nodeBatch"`
}

NodeLiveRevisionsResponse is returned by NodeLiveRevisions on success.

func NodeLiveRevisions added in v0.18.0 

func NodeLiveRevisions(
	ctx_ context.Context,
	client_ graphql.Client,
	refs []string,
	memory *string,
	locPrefix *string,
) (data_ *NodeLiveRevisionsResponse, err_ error)

Node.revision (#1323, hadron-server#1339), read ON ITS OWN by `node get` (not NodeRevisions, which is the revision HISTORY in revisions.graphql).

Not added to GetNode / NodeBatch: those back some thirty commands (spec, skill, coding, memory export …), and a server that predates the field rejects the WHOLE query that names it. Asked separately, a server without revisions costs `node get` one field it reports as unknown, never the read itself (#715: "truthful compatibility when an old server lacks revision data").

`node get` reads it BEFORE and AFTER the content, with the same selector as the content read (ids, refs, or memory + locPrefix), and keeps the content only when both agree: a revision advances on every authoring change, so equal brackets mean the content IS that revision (@codex on #724 — an updatedAt comparison is not collision-free).

func (*NodeLiveRevisionsResponse) GetNodeBatch added in v0.18.0 

func (v *NodeLiveRevisionsResponse) GetNodeBatch() *NodeLiveRevisionsNodeBatchNodeBatchResult

GetNodeBatch returns NodeLiveRevisionsResponse.NodeBatch, and is useful for accessing the field via an interface.

type NodeLiveRevisionsStampedNodeBatchNodeBatchResult added in v0.19.0 

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

NodeLiveRevisionsStampedNodeBatchNodeBatchResult includes the requested fields of the GraphQL type NodeBatchResult. The GraphQL type's documentation follows.

Spec cor:api:040 — result envelope for the batch node read (nodeBatch). 'nodes' is the authorized, existing subset (input order for a ref set, loc order for a prefix). 'unavailable' and 'omitted' are both lists of REFS, not node objects. 'unavailable' lists the requested refs that were denied OR not found — indistinguishable, so the result never discloses whether an unreadable node exists. 'truncated' is true when the response-size cap was reached, and 'omitted' then carries the refs of the nodes dropped to stay under it. (Over the node-count cap the query errors instead — never a silent short read.) Both lists echo the caller's OWN ref strings for the 'refs' form — pass a URN, get that URN back, not a primary key you never sent — and node ids for the prefix form, which has no caller refs.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetNodes added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetNodes() []*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode

GetNodes returns NodeLiveRevisionsStampedNodeBatchNodeBatchResult.Nodes, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetOmitted added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetOmitted() []string

GetOmitted returns NodeLiveRevisionsStampedNodeBatchNodeBatchResult.Omitted, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetTruncated added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetTruncated() bool

GetTruncated returns NodeLiveRevisionsStampedNodeBatchNodeBatchResult.Truncated, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetUnavailable added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResult) GetUnavailable() []string

GetUnavailable returns NodeLiveRevisionsStampedNodeBatchNodeBatchResult.Unavailable, and is useful for accessing the field via an interface.

type NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode added in v0.19.0 

type NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode struct {
	Id string `json:"id"`
	// #1323 — current live revision. Creation is revision 1; each committed authoring change advances it. NodeRevision.revNo N is the retained snapshot of this node when revision N was current, before the edit that advanced it.
	Revision int `json:"revision"`
	// #1326 — attribution of this content state. Null means legacy or unknown. Task identity is redacted unless its memory is independently readable.
	Authorship *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship `json:"authorship"`
	// #1326 — advisory validation for this exact revision. A report for an older revision is STALE.
	ContentValidation *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus `json:"contentValidation"`
}

NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode includes the requested fields of the GraphQL type Node.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetAuthorship added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetAuthorship() *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship

GetAuthorship returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode.Authorship, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetContentValidation added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetContentValidation() *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus

GetContentValidation returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode.ContentValidation, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetId added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetId() string

GetId returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode.Id, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetRevision added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode) GetRevision() int

GetRevision returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNode.Revision, and is useful for accessing the field via an interface.

type NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship added in v0.19.0 

type NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship struct {
	NodeAuthorshipFields `json:"-"`
}

NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship includes the requested fields of the GraphQL type NodeAuthorship.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetAuthoredAt added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetAuthoredAt() string

GetAuthoredAt returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship.AuthoredAt, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetHuman added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetHuman() *NodeAuthorshipFieldsHumanNodeRevisionEditor

GetHuman returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship.Human, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetKind added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetKind() NodeAuthorshipKind

GetKind returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship.Kind, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRef added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRef() *string

GetTaskRef returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship.TaskRef, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRevision added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) GetTaskRevision() *int

GetTaskRevision returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship.TaskRevision, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeAuthorship) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus added in v0.19.0 

type NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus struct {
	NodeContentValidationFields `json:"-"`
}

NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus includes the requested fields of the GraphQL type NodeContentValidationStatus.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetLatestReport added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetLatestReport() *NodeContentValidationFieldsLatestReportNodeContentValidationReport

GetLatestReport returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus.LatestReport, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetState added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) GetState() NodeContentValidationState

GetState returns NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus.State, and is useful for accessing the field via an interface.

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) MarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) MarshalJSON() ([]byte, error)

func (*NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeLiveRevisionsStampedNodeBatchNodeBatchResultNodesNodeContentValidationNodeContentValidationStatus) UnmarshalJSON(b []byte) error

type NodeLiveRevisionsStampedResponse added in v0.19.0 

type NodeLiveRevisionsStampedResponse 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 node(ref:) per node (e.g. 'spec lint --all'). Provide EITHER
	// 'refs' (explicit set, returned in input order) OR 'memory' + 'locPrefix'
	// (subtree, loc order) — not both. Each entry of 'refs' is a primary key OR a
	// fully-qualified node URN (cor:api:140), so a URN-holding caller batches in
	// ONE call instead of resolving each ref first. The split on a bad ref is by
	// KIND, not by luck: a ref whose SHAPE is wrong errors the call — unqualified
	// / relative (UrnNotQualifiedError) or a URN of the wrong entity type, e.g.
	// 'hrn:mem:...' (BAD_USER_INPUT) — while a well-formed ref that names nothing
	// the caller may read comes back in 'unavailable'. A caller mistake stays
	// loud instead of hiding among denials. Per-node access is applied
	// independently AFTER resolution: denied or missing refs 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 refs in 'omitted'
	// (never a silent short read). Node content is returned raw — Mustache
	// templates are NOT compiled (unlike the single-node 'node' read), since this
	// is a bulk source read for lint / audit / migration and compiling per node
	// would re-introduce the N+1 it eliminates.
	NodeBatch *NodeLiveRevisionsStampedNodeBatchNodeBatchResult `json:"nodeBatch"`
}

NodeLiveRevisionsStampedResponse is returned by NodeLiveRevisionsStamped on success.

func NodeLiveRevisionsStamped added in v0.19.0 

func NodeLiveRevisionsStamped(
	ctx_ context.Context,
	client_ graphql.Client,
	refs []string,
	memory *string,
	locPrefix *string,
) (data_ *NodeLiveRevisionsStampedResponse, err_ error)

cli#752 (hadron-server#1326): NodeLiveRevisions plus the server-authored stamps of each node's CURRENT revision — who authored this content state, and the advisory validation for exactly this revision. Read in the same bracket as the revision, so a printed stamp always describes the printed revision. Its own operation, so a server predating the stamps (a GraphQL validation refusal) falls back to NodeLiveRevisions and loses only the stamps.

func (*NodeLiveRevisionsStampedResponse) GetNodeBatch added in v0.19.0 

func (v *NodeLiveRevisionsStampedResponse) GetNodeBatch() *NodeLiveRevisionsStampedNodeBatchNodeBatchResult

GetNodeBatch returns NodeLiveRevisionsStampedResponse.NodeBatch, and is useful for accessing the field via an interface.

type NodeMergeField added in v0.7.0 

type NodeMergeField string

A node field that mergeNodes can fold from the source into the target. 

const (
	// Concatenate source abstract after target abstract (2000-char cap enforced).
	NodeMergeFieldAbstract NodeMergeField = "ABSTRACT"
	// Concatenate source content after target content (blank-line separated).
	NodeMergeFieldContent NodeMergeField = "CONTENT"
	// Shallow-merge the encrypted 'data' JSON; target wins on key collisions.
	NodeMergeFieldData NodeMergeField = "DATA"
	// Concatenate source description after target description.
	NodeMergeFieldDescription NodeMergeField = "DESCRIPTION"
	// Re-point the source's incoming and outgoing edges onto the target. Each re-homed edge's loc is recomputed from its new endpoints (deriveEdgeLoc); a re-homed edge whose recomputed (loc, memoryId) collides with one the target already holds is dropped rather than duplicated — so an equivalent edge with an endpoint-derived loc is de-duplicated — as are self-loops.
	NodeMergeFieldEdges NodeMergeField = "EDGES"
	// Shallow-merge the 'properties' JSON; target wins on key collisions.
	NodeMergeFieldProperties NodeMergeField = "PROPERTIES"
	// Union the tag sets (target order first, then new source tags).
	NodeMergeFieldTags NodeMergeField = "TAGS"
)

type NodeMintStatusFields added in v0.19.0 

type NodeMintStatusFields struct {
	Minted   bool    `json:"minted"`
	MintedAt *string `json:"mintedAt"`
	// The minting user's public identifiers; null when not a user (see mintedByInfo).
	MintedBy *NodeMintStatusFieldsMintedByNodeRevisionEditor `json:"mintedBy"`
	// The minting principal when no user is known, e.g. app:<id>, or backfill for nodes minted by the #1591 migration.
	MintedByInfo *string `json:"mintedByInfo"`
	// The revision that was minted. Null for nodes backfilled as minted, whose minted revision is unknown.
	Revision *int `json:"revision"`
	// The approval hash of the minted revision. Null for backfilled nodes, which were never approved.
	Hash *string `json:"hash"`
}

NodeMintStatusFields includes the GraphQL fields of NodeMintStatus requested by the fragment NodeMintStatusFields. The GraphQL type's documentation follows.

#1591 — whether a node is minted, and the record of it. Minting protects nothing by itself (permanence is off for now).

func (*NodeMintStatusFields) GetHash added in v0.19.0 

func (v *NodeMintStatusFields) GetHash() *string

GetHash returns NodeMintStatusFields.Hash, and is useful for accessing the field via an interface.

func (*NodeMintStatusFields) GetMinted added in v0.19.0 

func (v *NodeMintStatusFields) GetMinted() bool

GetMinted returns NodeMintStatusFields.Minted, and is useful for accessing the field via an interface.

func (*NodeMintStatusFields) GetMintedAt added in v0.19.0 

func (v *NodeMintStatusFields) GetMintedAt() *string

GetMintedAt returns NodeMintStatusFields.MintedAt, and is useful for accessing the field via an interface.

func (*NodeMintStatusFields) GetMintedBy added in v0.19.0 

func (v *NodeMintStatusFields) GetMintedBy() *NodeMintStatusFieldsMintedByNodeRevisionEditor

GetMintedBy returns NodeMintStatusFields.MintedBy, and is useful for accessing the field via an interface.

func (*NodeMintStatusFields) GetMintedByInfo added in v0.19.0 

func (v *NodeMintStatusFields) GetMintedByInfo() *string

GetMintedByInfo returns NodeMintStatusFields.MintedByInfo, and is useful for accessing the field via an interface.

func (*NodeMintStatusFields) GetRevision added in v0.19.0 

func (v *NodeMintStatusFields) GetRevision() *int

GetRevision returns NodeMintStatusFields.Revision, and is useful for accessing the field via an interface.

type NodeMintStatusFieldsMintedByNodeRevisionEditor added in v0.19.0 

type NodeMintStatusFieldsMintedByNodeRevisionEditor struct {
	Handle *string `json:"handle"`
	Urn    *string `json:"urn"`
}

NodeMintStatusFieldsMintedByNodeRevisionEditor includes the requested fields of the GraphQL type NodeRevisionEditor. The GraphQL type's documentation follows.

A revision's editor resolved to PUBLIC IDENTIFIERS ONLY (#617). Deliberately excludes name / email / any PII — resolving editedBy must never widen the disclosure surface. handle + urn are the same public identifiers the users search already exposes, so no per-caller visibility gate applies.

func (*NodeMintStatusFieldsMintedByNodeRevisionEditor) GetHandle added in v0.19.0 

func (v *NodeMintStatusFieldsMintedByNodeRevisionEditor) GetHandle() *string

GetHandle returns NodeMintStatusFieldsMintedByNodeRevisionEditor.Handle, and is useful for accessing the field via an interface.

func (*NodeMintStatusFieldsMintedByNodeRevisionEditor) GetUrn added in v0.19.0 

func (v *NodeMintStatusFieldsMintedByNodeRevisionEditor) GetUrn() *string

GetUrn returns NodeMintStatusFieldsMintedByNodeRevisionEditor.Urn, and is useful for accessing the field via an interface.

type NodeRevisionNodeRevision added in v0.7.0 

type NodeRevisionNodeRevision struct {
	RevisionFields `json:"-"`
	Content        *string `json:"content"`
}

NodeRevisionNodeRevision includes the requested fields of the GraphQL type NodeRevision.

func (*NodeRevisionNodeRevision) GetChanges added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetChanges() []string

GetChanges returns NodeRevisionNodeRevision.Changes, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetContent added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetContent() *string

GetContent returns NodeRevisionNodeRevision.Content, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetCreatedAt added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetCreatedAt() string

GetCreatedAt returns NodeRevisionNodeRevision.CreatedAt, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetDescription added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetDescription() *string

GetDescription returns NodeRevisionNodeRevision.Description, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetEditedBy added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetEditedBy() *string

GetEditedBy returns NodeRevisionNodeRevision.EditedBy, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetEditedByInfo added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetEditedByInfo() *string

GetEditedByInfo returns NodeRevisionNodeRevision.EditedByInfo, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetEditedByUser added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetEditedByUser() *RevisionFieldsEditedByUserNodeRevisionEditor

GetEditedByUser returns NodeRevisionNodeRevision.EditedByUser, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetId added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetId() string

GetId returns NodeRevisionNodeRevision.Id, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetLoc added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetLoc() string

GetLoc returns NodeRevisionNodeRevision.Loc, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetName added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetName() string

GetName returns NodeRevisionNodeRevision.Name, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetNodeId added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetNodeId() string

GetNodeId returns NodeRevisionNodeRevision.NodeId, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetRevLabel added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetRevLabel() *string

GetRevLabel returns NodeRevisionNodeRevision.RevLabel, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) GetTags added in v0.7.0 

func (v *NodeRevisionNodeRevision) GetTags() []string

GetTags returns NodeRevisionNodeRevision.Tags, and is useful for accessing the field via an interface.

func (*NodeRevisionNodeRevision) MarshalJSON added in v0.7.0 

func (v *NodeRevisionNodeRevision) MarshalJSON() ([]byte, error)

func (*NodeRevisionNodeRevision) UnmarshalJSON added in v0.7.0 

func (v *NodeRevisionNodeRevision) UnmarshalJSON(b []byte) error

type NodeRevisionResponse added in v0.7.0 

type NodeRevisionResponse struct {
	// A single node-revision snapshot by its id (#617 Display).
	//
	// Access-gated on the snapshot's node memory (read): null when the revision
	// does not exist OR the caller cannot read the node's current memory OR the
	// memory the snapshot was captured in (per-snapshot gating mirrors
	// nodeRevisions — a moved node keeps its id, so a snapshot may belong to a
	// memory the caller cannot read). A soft-deleted node is also null (its
	// history drops out of every read surface). Null, never an error, so there
	// is no existence disclosure.
	NodeRevision *NodeRevisionNodeRevision `json:"nodeRevision"`
}

NodeRevisionResponse is returned by NodeRevision on success.

func NodeRevision added in v0.7.0 

func NodeRevision(
	ctx_ context.Context,
	client_ graphql.Client,
	revisionId string,
) (data_ *NodeRevisionResponse, err_ error)

A single snapshot for display (adds content). Null — never an error — when the node is unreadable or soft-deleted, so there is no existence disclosure.

func (*NodeRevisionResponse) GetNodeRevision added in v0.7.0 

func (v *NodeRevisionResponse) GetNodeRevision() *NodeRevisionNodeRevision

GetNodeRevision returns NodeRevisionResponse.NodeRevision, and is useful for accessing the field via an interface.

type NodeRevisionStampedNodeRevision added in v0.19.0 

type NodeRevisionStampedNodeRevision struct {
	RevisionFields `json:"-"`
	Content        *string `json:"content"`
	// #1326 — attribution of the content captured before the next edit.
	Authorship *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship `json:"authorship"`
	// #1326 — advisory validation at this historical revision.
	ContentValidation *NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus `json:"contentValidation"`
}

NodeRevisionStampedNodeRevision includes the requested fields of the GraphQL type NodeRevision.

func (*NodeRevisionStampedNodeRevision) GetAuthorship added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetAuthorship() *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship

GetAuthorship returns NodeRevisionStampedNodeRevision.Authorship, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetChanges added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetChanges() []string

GetChanges returns NodeRevisionStampedNodeRevision.Changes, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetContent added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetContent() *string

GetContent returns NodeRevisionStampedNodeRevision.Content, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetContentValidation added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetContentValidation() *NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus

GetContentValidation returns NodeRevisionStampedNodeRevision.ContentValidation, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetCreatedAt added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetCreatedAt() string

GetCreatedAt returns NodeRevisionStampedNodeRevision.CreatedAt, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetDescription added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetDescription() *string

GetDescription returns NodeRevisionStampedNodeRevision.Description, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetEditedBy added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetEditedBy() *string

GetEditedBy returns NodeRevisionStampedNodeRevision.EditedBy, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetEditedByInfo added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetEditedByInfo() *string

GetEditedByInfo returns NodeRevisionStampedNodeRevision.EditedByInfo, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetEditedByUser added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetEditedByUser() *RevisionFieldsEditedByUserNodeRevisionEditor

GetEditedByUser returns NodeRevisionStampedNodeRevision.EditedByUser, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetId added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetId() string

GetId returns NodeRevisionStampedNodeRevision.Id, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetLoc added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetLoc() string

GetLoc returns NodeRevisionStampedNodeRevision.Loc, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetName added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetName() string

GetName returns NodeRevisionStampedNodeRevision.Name, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetNodeId added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetNodeId() string

GetNodeId returns NodeRevisionStampedNodeRevision.NodeId, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetRevLabel added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetRevLabel() *string

GetRevLabel returns NodeRevisionStampedNodeRevision.RevLabel, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) GetTags added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) GetTags() []string

GetTags returns NodeRevisionStampedNodeRevision.Tags, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevision) MarshalJSON added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) MarshalJSON() ([]byte, error)

func (*NodeRevisionStampedNodeRevision) UnmarshalJSON added in v0.19.0 

func (v *NodeRevisionStampedNodeRevision) UnmarshalJSON(b []byte) error

type NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship added in v0.19.0 

type NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship struct {
	NodeAuthorshipFields `json:"-"`
}

NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship includes the requested fields of the GraphQL type NodeAuthorship.

func (*NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetAuthoredAt added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetAuthoredAt() string

GetAuthoredAt returns NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship.AuthoredAt, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetHuman added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetHuman() *NodeAuthorshipFieldsHumanNodeRevisionEditor

GetHuman returns NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship.Human, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetKind added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetKind() NodeAuthorshipKind

GetKind returns NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship.Kind, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetTaskRef added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetTaskRef() *string

GetTaskRef returns NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship.TaskRef, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetTaskRevision added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) GetTaskRevision() *int

GetTaskRevision returns NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship.TaskRevision, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) MarshalJSON added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) MarshalJSON() ([]byte, error)

func (*NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) UnmarshalJSON added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionAuthorshipNodeAuthorship) UnmarshalJSON(b []byte) error

type NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus added in v0.19.0 

type NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus struct {
	NodeContentValidationFields `json:"-"`
}

NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus includes the requested fields of the GraphQL type NodeContentValidationStatus.

func (*NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) GetLatestReport added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) GetLatestReport() *NodeContentValidationFieldsLatestReportNodeContentValidationReport

GetLatestReport returns NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus.LatestReport, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) GetState added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) GetState() NodeContentValidationState

GetState returns NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus.State, and is useful for accessing the field via an interface.

func (*NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) MarshalJSON added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) MarshalJSON() ([]byte, error)

func (*NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeRevisionStampedNodeRevisionContentValidationNodeContentValidationStatus) UnmarshalJSON(b []byte) error

type NodeRevisionStampedResponse added in v0.19.0 

type NodeRevisionStampedResponse struct {
	// A single node-revision snapshot by its id (#617 Display).
	//
	// Access-gated on the snapshot's node memory (read): null when the revision
	// does not exist OR the caller cannot read the node's current memory OR the
	// memory the snapshot was captured in (per-snapshot gating mirrors
	// nodeRevisions — a moved node keeps its id, so a snapshot may belong to a
	// memory the caller cannot read). A soft-deleted node is also null (its
	// history drops out of every read surface). Null, never an error, so there
	// is no existence disclosure.
	NodeRevision *NodeRevisionStampedNodeRevision `json:"nodeRevision"`
}

NodeRevisionStampedResponse is returned by NodeRevisionStamped on success.

func NodeRevisionStamped added in v0.19.0 

func NodeRevisionStamped(
	ctx_ context.Context,
	client_ graphql.Client,
	revisionId string,
) (data_ *NodeRevisionStampedResponse, err_ error)

func (*NodeRevisionStampedResponse) GetNodeRevision added in v0.19.0 

func (v *NodeRevisionStampedResponse) GetNodeRevision() *NodeRevisionStampedNodeRevision

GetNodeRevision returns NodeRevisionStampedResponse.NodeRevision, and is useful for accessing the field via an interface.

type NodeRevisionsNodeRevisionsNodeRevision added in v0.7.0 

type NodeRevisionsNodeRevisionsNodeRevision struct {
	RevisionFields `json:"-"`
}

NodeRevisionsNodeRevisionsNodeRevision includes the requested fields of the GraphQL type NodeRevision.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetChanges added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetChanges() []string

GetChanges returns NodeRevisionsNodeRevisionsNodeRevision.Changes, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetCreatedAt added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetCreatedAt() string

GetCreatedAt returns NodeRevisionsNodeRevisionsNodeRevision.CreatedAt, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetDescription added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetDescription() *string

GetDescription returns NodeRevisionsNodeRevisionsNodeRevision.Description, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetEditedBy added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetEditedBy() *string

GetEditedBy returns NodeRevisionsNodeRevisionsNodeRevision.EditedBy, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetEditedByInfo added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetEditedByInfo() *string

GetEditedByInfo returns NodeRevisionsNodeRevisionsNodeRevision.EditedByInfo, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetEditedByUser added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetEditedByUser() *RevisionFieldsEditedByUserNodeRevisionEditor

GetEditedByUser returns NodeRevisionsNodeRevisionsNodeRevision.EditedByUser, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetId added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetId() string

GetId returns NodeRevisionsNodeRevisionsNodeRevision.Id, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetLoc added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetLoc() string

GetLoc returns NodeRevisionsNodeRevisionsNodeRevision.Loc, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetName added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetName() string

GetName returns NodeRevisionsNodeRevisionsNodeRevision.Name, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetNodeId added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetNodeId() string

GetNodeId returns NodeRevisionsNodeRevisionsNodeRevision.NodeId, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetRevLabel added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetRevLabel() *string

GetRevLabel returns NodeRevisionsNodeRevisionsNodeRevision.RevLabel, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) GetTags added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) GetTags() []string

GetTags returns NodeRevisionsNodeRevisionsNodeRevision.Tags, and is useful for accessing the field via an interface.

func (*NodeRevisionsNodeRevisionsNodeRevision) MarshalJSON added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) MarshalJSON() ([]byte, error)

func (*NodeRevisionsNodeRevisionsNodeRevision) UnmarshalJSON added in v0.7.0 

func (v *NodeRevisionsNodeRevisionsNodeRevision) UnmarshalJSON(b []byte) error

type NodeRevisionsResponse added in v0.7.0 

type NodeRevisionsResponse struct {
	// Revision history for a node, most recent first.
	//
	// Accepts the node's ID or URN. Access-gated on the node's memory: a node
	// whose memory the caller can't read returns an empty list (no existence
	// disclosure).
	NodeRevisions []*NodeRevisionsNodeRevisionsNodeRevision `json:"nodeRevisions"`
}

NodeRevisionsResponse is returned by NodeRevisions on success.

func NodeRevisions added in v0.7.0 

func NodeRevisions(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
	limit *int,
) (data_ *NodeRevisionsResponse, err_ error)

History for a node, most-recent-first. Per-snapshot memory-gated server-side.

func (*NodeRevisionsResponse) GetNodeRevisions added in v0.7.0 

func (v *NodeRevisionsResponse) GetNodeRevisions() []*NodeRevisionsNodeRevisionsNodeRevision

GetNodeRevisions returns NodeRevisionsResponse.NodeRevisions, and is useful for accessing the field via an interface.

type NodeRevisionsStampedNodeRevisionsNodeRevision added in v0.19.0 

type NodeRevisionsStampedNodeRevisionsNodeRevision struct {
	RevisionFields `json:"-"`
	// #1326 — attribution of the content captured before the next edit.
	Authorship *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship `json:"authorship"`
	// #1326 — advisory validation at this historical revision.
	ContentValidation *NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus `json:"contentValidation"`
}

NodeRevisionsStampedNodeRevisionsNodeRevision includes the requested fields of the GraphQL type NodeRevision.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetAuthorship added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetAuthorship() *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship

GetAuthorship returns NodeRevisionsStampedNodeRevisionsNodeRevision.Authorship, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetChanges added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetChanges() []string

GetChanges returns NodeRevisionsStampedNodeRevisionsNodeRevision.Changes, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetContentValidation added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetContentValidation() *NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus

GetContentValidation returns NodeRevisionsStampedNodeRevisionsNodeRevision.ContentValidation, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetCreatedAt added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetCreatedAt() string

GetCreatedAt returns NodeRevisionsStampedNodeRevisionsNodeRevision.CreatedAt, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetDescription added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetDescription() *string

GetDescription returns NodeRevisionsStampedNodeRevisionsNodeRevision.Description, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetEditedBy added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetEditedBy() *string

GetEditedBy returns NodeRevisionsStampedNodeRevisionsNodeRevision.EditedBy, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetEditedByInfo added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetEditedByInfo() *string

GetEditedByInfo returns NodeRevisionsStampedNodeRevisionsNodeRevision.EditedByInfo, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetEditedByUser added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetEditedByUser() *RevisionFieldsEditedByUserNodeRevisionEditor

GetEditedByUser returns NodeRevisionsStampedNodeRevisionsNodeRevision.EditedByUser, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetId added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetId() string

GetId returns NodeRevisionsStampedNodeRevisionsNodeRevision.Id, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetLoc added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetLoc() string

GetLoc returns NodeRevisionsStampedNodeRevisionsNodeRevision.Loc, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetName added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetName() string

GetName returns NodeRevisionsStampedNodeRevisionsNodeRevision.Name, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetNodeId added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetNodeId() string

GetNodeId returns NodeRevisionsStampedNodeRevisionsNodeRevision.NodeId, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetRevLabel added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetRevLabel() *string

GetRevLabel returns NodeRevisionsStampedNodeRevisionsNodeRevision.RevLabel, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) GetTags added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) GetTags() []string

GetTags returns NodeRevisionsStampedNodeRevisionsNodeRevision.Tags, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) MarshalJSON added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) MarshalJSON() ([]byte, error)

func (*NodeRevisionsStampedNodeRevisionsNodeRevision) UnmarshalJSON added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevision) UnmarshalJSON(b []byte) error

type NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship added in v0.19.0 

type NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship struct {
	NodeAuthorshipFields `json:"-"`
}

NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship includes the requested fields of the GraphQL type NodeAuthorship.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetAuthoredAt added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetAuthoredAt() string

GetAuthoredAt returns NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship.AuthoredAt, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetHuman added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetHuman() *NodeAuthorshipFieldsHumanNodeRevisionEditor

GetHuman returns NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship.Human, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetKind added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetKind() NodeAuthorshipKind

GetKind returns NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship.Kind, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetTaskRef added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetTaskRef() *string

GetTaskRef returns NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship.TaskRef, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetTaskRevision added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) GetTaskRevision() *int

GetTaskRevision returns NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship.TaskRevision, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) MarshalJSON added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) MarshalJSON() ([]byte, error)

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) UnmarshalJSON added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionAuthorshipNodeAuthorship) UnmarshalJSON(b []byte) error

type NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus added in v0.19.0 

type NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus struct {
	NodeContentValidationFields `json:"-"`
}

NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus includes the requested fields of the GraphQL type NodeContentValidationStatus.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) GetLatestReport added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) GetLatestReport() *NodeContentValidationFieldsLatestReportNodeContentValidationReport

GetLatestReport returns NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus.LatestReport, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) GetState added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) GetState() NodeContentValidationState

GetState returns NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus.State, and is useful for accessing the field via an interface.

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) MarshalJSON added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) MarshalJSON() ([]byte, error)

func (*NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) UnmarshalJSON added in v0.19.0 

func (v *NodeRevisionsStampedNodeRevisionsNodeRevisionContentValidationNodeContentValidationStatus) UnmarshalJSON(b []byte) error

type NodeRevisionsStampedResponse added in v0.19.0 

type NodeRevisionsStampedResponse struct {
	// Revision history for a node, most recent first.
	//
	// Accepts the node's ID or URN. Access-gated on the node's memory: a node
	// whose memory the caller can't read returns an empty list (no existence
	// disclosure).
	NodeRevisions []*NodeRevisionsStampedNodeRevisionsNodeRevision `json:"nodeRevisions"`
}

NodeRevisionsStampedResponse is returned by NodeRevisionsStamped on success.

func NodeRevisionsStamped added in v0.19.0 

func NodeRevisionsStamped(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
	limit *int,
) (data_ *NodeRevisionsStampedResponse, err_ error)

cli#752 (hadron-server#1326): the same reads with each snapshot's own stamps — the authorship of the content it captured, and the validation AT that revision. Historical evidence, shown as the server snapshotted it, never reconstructed from the live node or task. Separate operations so a server predating the stamps falls back to the two above and loses only the stamps.

func (*NodeRevisionsStampedResponse) GetNodeRevisions added in v0.19.0 

func (v *NodeRevisionsStampedResponse) GetNodeRevisions() []*NodeRevisionsStampedNodeRevisionsNodeRevision

GetNodeRevisions returns NodeRevisionsStampedResponse.NodeRevisions, and is useful for accessing the field via an interface.

type NodeRoleRuleFields added in v0.18.0 

type NodeRoleRuleFields struct {
	// The rule's id — its ref for updateNodeRoleRule / deleteNodeRoleRule (a rule has no URN).
	Id string `json:"id"`
	// The dotted role or sub-role this rule governs, unique within the config.
	Role string `json:"role"`
	// Optimistic-concurrency token: pass it as expectedRevision to update or delete.
	Revision int  `json:"revision"`
	Enabled  bool `json:"enabled"`
	// On a parent role: refuse its undeclared sub-roles instead of falling back to it.
	StrictSubRoles      bool                 `json:"strictSubRoles"`
	Writers             NodeRoleWriters      `json:"writers"`
	ValidateBy          *ContentValidator    `json:"validateBy"`
	AuthorTask          *string              `json:"authorTask"`
	AuthorTaskId        *string              `json:"authorTaskId"`
	AuthorTaskState     NodeRoleRuleRefState `json:"authorTaskState"`
	ValidationTask      *string              `json:"validationTask"`
	ValidationTaskId    *string              `json:"validationTaskId"`
	ValidationTaskState NodeRoleRuleRefState `json:"validationTaskState"`
	// Documentation, not procedure: a deleted description node reads as NONE, never BROKEN.
	DescriptionNode      *string              `json:"descriptionNode"`
	DescriptionNodeId    *string              `json:"descriptionNodeId"`
	DescriptionNodeState NodeRoleRuleRefState `json:"descriptionNodeState"`
	// Set by applying a required template (#1334). A locked rule refuses every ordinary edit and delete (RULE_LOCKED); unlockNodeRoleRule is the deliberate step.
	Locked bool `json:"locked"`
	// The template this rule was copied from, if any (provenance only; no live link).
	SourceTemplateId *string                                                     `json:"sourceTemplateId"`
	SourceTemplate   *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate `json:"sourceTemplate"`
	CreatedAt        string                                                      `json:"createdAt"`
	CreatedBy        *string                                                     `json:"createdBy"`
	UpdatedAt        *string                                                     `json:"updatedAt"`
	UpdatedBy        *string                                                     `json:"updatedBy"`
}

NodeRoleRuleFields includes the GraphQL fields of NodeRoleRule requested by the fragment NodeRoleRuleFields. The GraphQL type's documentation follows.

#1325 — one node-role rule. Task and description references are stored by node id (they survive moves) and returned as a URN and an id, each with its state. Both are given only when the state is OK; see NodeRoleRuleRefState.

func (*NodeRoleRuleFields) GetAuthorTask added in v0.18.0 

func (v *NodeRoleRuleFields) GetAuthorTask() *string

GetAuthorTask returns NodeRoleRuleFields.AuthorTask, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetAuthorTaskId added in v0.18.0 

func (v *NodeRoleRuleFields) GetAuthorTaskId() *string

GetAuthorTaskId returns NodeRoleRuleFields.AuthorTaskId, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetAuthorTaskState added in v0.18.0 

func (v *NodeRoleRuleFields) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns NodeRoleRuleFields.AuthorTaskState, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetCreatedAt added in v0.18.0 

func (v *NodeRoleRuleFields) GetCreatedAt() string

GetCreatedAt returns NodeRoleRuleFields.CreatedAt, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetCreatedBy added in v0.18.0 

func (v *NodeRoleRuleFields) GetCreatedBy() *string

GetCreatedBy returns NodeRoleRuleFields.CreatedBy, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetDescriptionNode added in v0.18.0 

func (v *NodeRoleRuleFields) GetDescriptionNode() *string

GetDescriptionNode returns NodeRoleRuleFields.DescriptionNode, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetDescriptionNodeId added in v0.18.0 

func (v *NodeRoleRuleFields) GetDescriptionNodeId() *string

GetDescriptionNodeId returns NodeRoleRuleFields.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetDescriptionNodeState added in v0.18.0 

func (v *NodeRoleRuleFields) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns NodeRoleRuleFields.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetEnabled added in v0.18.0 

func (v *NodeRoleRuleFields) GetEnabled() bool

GetEnabled returns NodeRoleRuleFields.Enabled, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetId added in v0.18.0 

func (v *NodeRoleRuleFields) GetId() string

GetId returns NodeRoleRuleFields.Id, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetLocked added in v0.18.0 

func (v *NodeRoleRuleFields) GetLocked() bool

GetLocked returns NodeRoleRuleFields.Locked, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetRevision added in v0.18.0 

func (v *NodeRoleRuleFields) GetRevision() int

GetRevision returns NodeRoleRuleFields.Revision, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetRole added in v0.18.0 

func (v *NodeRoleRuleFields) GetRole() string

GetRole returns NodeRoleRuleFields.Role, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetSourceTemplate added in v0.18.0 

func (v *NodeRoleRuleFields) GetSourceTemplate() *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate

GetSourceTemplate returns NodeRoleRuleFields.SourceTemplate, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetSourceTemplateId added in v0.18.0 

func (v *NodeRoleRuleFields) GetSourceTemplateId() *string

GetSourceTemplateId returns NodeRoleRuleFields.SourceTemplateId, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetStrictSubRoles added in v0.18.0 

func (v *NodeRoleRuleFields) GetStrictSubRoles() bool

GetStrictSubRoles returns NodeRoleRuleFields.StrictSubRoles, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetUpdatedAt added in v0.18.0 

func (v *NodeRoleRuleFields) GetUpdatedAt() *string

GetUpdatedAt returns NodeRoleRuleFields.UpdatedAt, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetUpdatedBy added in v0.18.0 

func (v *NodeRoleRuleFields) GetUpdatedBy() *string

GetUpdatedBy returns NodeRoleRuleFields.UpdatedBy, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetValidateBy added in v0.18.0 

func (v *NodeRoleRuleFields) GetValidateBy() *ContentValidator

GetValidateBy returns NodeRoleRuleFields.ValidateBy, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetValidationTask added in v0.18.0 

func (v *NodeRoleRuleFields) GetValidationTask() *string

GetValidationTask returns NodeRoleRuleFields.ValidationTask, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetValidationTaskId added in v0.18.0 

func (v *NodeRoleRuleFields) GetValidationTaskId() *string

GetValidationTaskId returns NodeRoleRuleFields.ValidationTaskId, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetValidationTaskState added in v0.18.0 

func (v *NodeRoleRuleFields) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns NodeRoleRuleFields.ValidationTaskState, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFields) GetWriters added in v0.18.0 

func (v *NodeRoleRuleFields) GetWriters() NodeRoleWriters

GetWriters returns NodeRoleRuleFields.Writers, and is useful for accessing the field via an interface.

type NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate added in v0.18.0 

type NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate struct {
	Id   string `json:"id"`
	Name string `json:"name"`
	// The template has been deleted; the rule keeps its copy.
	Deleted bool `json:"deleted"`
}

NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate includes the requested fields of the GraphQL type NodeRoleRuleSourceTemplate.

func (*NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate) GetDeleted added in v0.18.0 

func (v *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate) GetDeleted() bool

GetDeleted returns NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate.Deleted, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate) GetId added in v0.18.0 

func (v *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate) GetId() string

GetId returns NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate.Id, and is useful for accessing the field via an interface.

func (*NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate) GetName added in v0.18.0 

func (v *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate) GetName() string

GetName returns NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate.Name, and is useful for accessing the field via an interface.

type NodeRoleRuleRefState added in v0.18.0 

type NodeRoleRuleRefState string

#1325 — the state of one rule reference, next to its URN and id. NONE: not configured. OK: the node is live and you can read it; its id is given, and its URN too unless the node's memory has a legacy URN that cannot address it (#697), when the URN is null and the id is the ref to use. BROKEN: configured, but the node was deleted, so operations relying on the rule are refused until a manager repoints it (fail-closed). UNREADABLE: the node exists but you may not read it, so its URN and id are withheld. 

const (
	NodeRoleRuleRefStateBroken     NodeRoleRuleRefState = "BROKEN"
	NodeRoleRuleRefStateNone       NodeRoleRuleRefState = "NONE"
	NodeRoleRuleRefStateOk         NodeRoleRuleRefState = "OK"
	NodeRoleRuleRefStateUnreadable NodeRoleRuleRefState = "UNREADABLE"
)

type NodeRoleWriters added in v0.18.0 

type NodeRoleWriters string
const (
	NodeRoleWritersAdmin NodeRoleWriters = "ADMIN"
	NodeRoleWritersAll   NodeRoleWriters = "ALL"
	NodeRoleWritersOwner NodeRoleWriters = "OWNER"
)

type NodeSort added in v0.5.0 

type NodeSort string

Result ordering for findNodes. Default relevance; the rest suppress scoring (browse order). 

const (
	NodeSortLoc       NodeSort = "loc"
	NodeSortRelevance NodeSort = "relevance"
	NodeSortSeq       NodeSort = "seq"
	NodeSortUpdatedat NodeSort = "updatedAt"
)

type NodeTextField added in v0.3.1 

type NodeTextField string

Text-bearing Node fields that searchReplaceInNodes may rewrite. JSON fields (data, properties) and the structural 'loc' are intentionally excluded in v1. 

const (
	NodeTextFieldAbstract    NodeTextField = "abstract"
	NodeTextFieldAlias       NodeTextField = "alias"
	NodeTextFieldContent     NodeTextField = "content"
	NodeTextFieldDescription NodeTextField = "description"
	NodeTextFieldName        NodeTextField = "name"
	NodeTextFieldTags        NodeTextField = "tags"
)

type OrgFields added in v0.3.0 

type OrgFields struct {
	Id   string `json:"id"`
	Urn  string `json:"urn"`
	Name string `json:"name"`
	// cor:acl:080:04 — opt-in marketplace catalogue flag (advertisement, not access).
	ListedOnMarketplace bool   `json:"listedOnMarketplace"`
	CreatedAt           string `json:"createdAt"`
	UpdatedAt           string `json:"updatedAt"`
}

OrgFields includes the GraphQL fields of Organization requested by the fragment OrgFields. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*OrgFields) GetCreatedAt added in v0.3.0 

func (v *OrgFields) GetCreatedAt() string

GetCreatedAt returns OrgFields.CreatedAt, and is useful for accessing the field via an interface.

func (*OrgFields) GetId added in v0.3.0 

func (v *OrgFields) GetId() string

GetId returns OrgFields.Id, and is useful for accessing the field via an interface.

func (*OrgFields) GetListedOnMarketplace added in v0.9.0 

func (v *OrgFields) GetListedOnMarketplace() bool

GetListedOnMarketplace returns OrgFields.ListedOnMarketplace, and is useful for accessing the field via an interface.

func (*OrgFields) GetName added in v0.3.0 

func (v *OrgFields) GetName() string

GetName returns OrgFields.Name, and is useful for accessing the field via an interface.

func (*OrgFields) GetUpdatedAt added in v0.3.0 

func (v *OrgFields) GetUpdatedAt() string

GetUpdatedAt returns OrgFields.UpdatedAt, and is useful for accessing the field via an interface.

func (*OrgFields) GetUrn added in v0.3.0 

func (v *OrgFields) GetUrn() string

GetUrn returns OrgFields.Urn, and is useful for accessing the field via an interface.

type OrgMembersOrganization added in v0.3.0 

type OrgMembersOrganization struct {
	Id      string                                    `json:"id"`
	Members []*OrgMembersOrganizationMembersOrgMember `json:"members"`
}

OrgMembersOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*OrgMembersOrganization) GetId added in v0.3.0 

func (v *OrgMembersOrganization) GetId() string

GetId returns OrgMembersOrganization.Id, and is useful for accessing the field via an interface.

func (*OrgMembersOrganization) GetMembers added in v0.3.0 

func (v *OrgMembersOrganization) GetMembers() []*OrgMembersOrganizationMembersOrgMember

GetMembers returns OrgMembersOrganization.Members, and is useful for accessing the field via an interface.

type OrgMembersOrganizationMembersOrgMember added in v0.3.0 

type OrgMembersOrganizationMembersOrgMember struct {
	Id string `json:"id"`
	// Target member's role in this org. Null when the viewer isn't an ADMIN/OWNER of the org (#384 field-level visibility); always visible for one's own membership.
	Role      *Role                                       `json:"role"`
	CanInvite bool                                        `json:"canInvite"`
	User      *OrgMembersOrganizationMembersOrgMemberUser `json:"user"`
}

OrgMembersOrganizationMembersOrgMember includes the requested fields of the GraphQL type OrgMember. The GraphQL type's documentation follows.

Per-organization membership record for a user.

func (*OrgMembersOrganizationMembersOrgMember) GetCanInvite added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMember) GetCanInvite() bool

GetCanInvite returns OrgMembersOrganizationMembersOrgMember.CanInvite, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMember) GetId added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMember) GetId() string

GetId returns OrgMembersOrganizationMembersOrgMember.Id, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMember) GetRole added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMember) GetRole() *Role

GetRole returns OrgMembersOrganizationMembersOrgMember.Role, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMember) GetUser added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMember) GetUser() *OrgMembersOrganizationMembersOrgMemberUser

GetUser returns OrgMembersOrganizationMembersOrgMember.User, and is useful for accessing the field via an interface.

type OrgMembersOrganizationMembersOrgMemberUser added in v0.3.0 

type OrgMembersOrganizationMembersOrgMemberUser struct {
	UserFields `json:"-"`
}

OrgMembersOrganizationMembersOrgMemberUser includes the requested fields of the GraphQL type User.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetEmail added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetEmail() *string

GetEmail returns OrgMembersOrganizationMembersOrgMemberUser.Email, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetExternalAppId added in v0.9.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetExternalAppId() *string

GetExternalAppId returns OrgMembersOrganizationMembersOrgMemberUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetExternalId added in v0.9.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetExternalId() *string

GetExternalId returns OrgMembersOrganizationMembersOrgMemberUser.ExternalId, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetGithubId added in v0.9.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetGithubId() *int

GetGithubId returns OrgMembersOrganizationMembersOrgMemberUser.GithubId, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetGithubUsername added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetGithubUsername() *string

GetGithubUsername returns OrgMembersOrganizationMembersOrgMemberUser.GithubUsername, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetHandle added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetHandle() *string

GetHandle returns OrgMembersOrganizationMembersOrgMemberUser.Handle, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetId added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetId() string

GetId returns OrgMembersOrganizationMembersOrgMemberUser.Id, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetIdentityProvider added in v0.9.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetIdentityProvider() *string

GetIdentityProvider returns OrgMembersOrganizationMembersOrgMemberUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetLinkedAt added in v0.9.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetLinkedAt() *string

GetLinkedAt returns OrgMembersOrganizationMembersOrgMemberUser.LinkedAt, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetName added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetName() *string

GetName returns OrgMembersOrganizationMembersOrgMemberUser.Name, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetRoles added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetRoles() []Role

GetRoles returns OrgMembersOrganizationMembersOrgMemberUser.Roles, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) GetUrn added in v0.14.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) GetUrn() *string

GetUrn returns OrgMembersOrganizationMembersOrgMemberUser.Urn, and is useful for accessing the field via an interface.

func (*OrgMembersOrganizationMembersOrgMemberUser) MarshalJSON added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) MarshalJSON() ([]byte, error)

func (*OrgMembersOrganizationMembersOrgMemberUser) UnmarshalJSON added in v0.3.0 

func (v *OrgMembersOrganizationMembersOrgMemberUser) UnmarshalJSON(b []byte) error

type OrgMembersResponse added in v0.3.0 

type OrgMembersResponse struct {
	// Fetch an Organization (org member or platform ADMIN).
	//
	// 'ref' accepts the entity's ID or URN.
	Organization *OrgMembersOrganization `json:"organization"`
}

OrgMembersResponse is returned by OrgMembers on success.

func OrgMembers added in v0.3.0 

func OrgMembers(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *OrgMembersResponse, err_ error)

organization(ref) is the only path to an org's members.

func (*OrgMembersResponse) GetOrganization added in v0.3.0 

func (v *OrgMembersResponse) GetOrganization() *OrgMembersOrganization

GetOrganization returns OrgMembersResponse.Organization, and is useful for accessing the field via an interface.

type OrganizationFilter added in v0.7.0 

type OrganizationFilter struct {
	// true restricts the list to the caller's own memberships — even for
	// platform ADMIN/OWNER, whose unscoped reach otherwise spans every live
	// org; the old myOrganizations semantics.
	MemberOnly *bool `json:"memberOnly"`
}

Filter for the uniform organizations() list (#473).

func (*OrganizationFilter) GetMemberOnly added in v0.7.0 

func (v *OrganizationFilter) GetMemberOnly() *bool

GetMemberOnly returns OrganizationFilter.MemberOnly, and is useful for accessing the field via an interface.

type OrganizationsOrganizationsOrganizationsPage added in v0.7.0 

type OrganizationsOrganizationsOrganizationsPage struct {
	Total int                                                             `json:"total"`
	Items []*OrganizationsOrganizationsOrganizationsPageItemsOrganization `json:"items"`
}

OrganizationsOrganizationsOrganizationsPage includes the requested fields of the GraphQL type OrganizationsPage.

func (*OrganizationsOrganizationsOrganizationsPage) GetItems added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPage) GetItems() []*OrganizationsOrganizationsOrganizationsPageItemsOrganization

GetItems returns OrganizationsOrganizationsOrganizationsPage.Items, and is useful for accessing the field via an interface.

func (*OrganizationsOrganizationsOrganizationsPage) GetTotal added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPage) GetTotal() int

GetTotal returns OrganizationsOrganizationsOrganizationsPage.Total, and is useful for accessing the field via an interface.

type OrganizationsOrganizationsOrganizationsPageItemsOrganization added in v0.7.0 

type OrganizationsOrganizationsOrganizationsPageItemsOrganization struct {
	OrgFields `json:"-"`
}

OrganizationsOrganizationsOrganizationsPageItemsOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetCreatedAt added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetCreatedAt() string

GetCreatedAt returns OrganizationsOrganizationsOrganizationsPageItemsOrganization.CreatedAt, and is useful for accessing the field via an interface.

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetId added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetId() string

GetId returns OrganizationsOrganizationsOrganizationsPageItemsOrganization.Id, and is useful for accessing the field via an interface.

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetListedOnMarketplace added in v0.9.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetListedOnMarketplace() bool

GetListedOnMarketplace returns OrganizationsOrganizationsOrganizationsPageItemsOrganization.ListedOnMarketplace, and is useful for accessing the field via an interface.

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetName added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetName() string

GetName returns OrganizationsOrganizationsOrganizationsPageItemsOrganization.Name, and is useful for accessing the field via an interface.

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetUpdatedAt added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetUpdatedAt() string

GetUpdatedAt returns OrganizationsOrganizationsOrganizationsPageItemsOrganization.UpdatedAt, and is useful for accessing the field via an interface.

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetUrn added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) GetUrn() string

GetUrn returns OrganizationsOrganizationsOrganizationsPageItemsOrganization.Urn, and is useful for accessing the field via an interface.

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) MarshalJSON added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) MarshalJSON() ([]byte, error)

func (*OrganizationsOrganizationsOrganizationsPageItemsOrganization) UnmarshalJSON added in v0.7.0 

func (v *OrganizationsOrganizationsOrganizationsPageItemsOrganization) UnmarshalJSON(b []byte) error

type OrganizationsResponse added in v0.7.0 

type OrganizationsResponse struct {
	// Uniform paginated organization list (#473) — replaces organizations +
	// myOrganizations. Scope: the caller's memberships; platform ADMIN/OWNER
	// get every live org (the established admin unscoped reach) unless
	// filter.memberOnly restricts the list to their own memberships (the old
	// myOrganizations view, as a slice-as-filter). Name-ascending order (id
	// tiebreak); limit default 50 / cap 200; limit: 0 -> count only.
	Organizations *OrganizationsOrganizationsOrganizationsPage `json:"organizations"`
}

OrganizationsResponse is returned by Organizations on success.

func Organizations added in v0.7.0 

func Organizations(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *OrganizationFilter,
	limit *int,
	offset *int,
) (data_ *OrganizationsResponse, err_ error)

Organizations list (#473 uniform surface) — for `org ls`. Unscoped spans every org the caller can see (all live orgs for a platform admin); memberOnly restricts to the caller's own memberships.

func (*OrganizationsResponse) GetOrganizations added in v0.7.0 

func (v *OrganizationsResponse) GetOrganizations() *OrganizationsOrganizationsOrganizationsPage

GetOrganizations returns OrganizationsResponse.Organizations, and is useful for accessing the field via an interface.

type PrincipalGrantFields added in v0.7.0 

type PrincipalGrantFields struct {
	Id string `json:"id"`
	// Grantee kind - 'USER' in v1.
	PrincipalType   string  `json:"principalType"`
	PrincipalId     string  `json:"principalId"`
	PrincipalHandle *string `json:"principalHandle"`
	OrganizationId  string  `json:"organizationId"`
	OrganizationUrn *string `json:"organizationUrn"`
	// Allowed actions - exact ('memory.clone'), prefix ('memory.*'), or '*'.
	Actions []string `json:"actions"`
	// ISO-8601 expiry, or null for perpetual (until revoked).
	ExpiresAt *string `json:"expiresAt"`
	CreatedAt string  `json:"createdAt"`
}

PrincipalGrantFields includes the GraphQL fields of PrincipalGrant requested by the fragment PrincipalGrantFields. The GraphQL type's documentation follows.

An individual action grant (design:grant-model): extra management actions for one member of one org, on top of their role bundle. Grantee and org are projected as scalars, never nested objects.

func (*PrincipalGrantFields) GetActions added in v0.7.0 

func (v *PrincipalGrantFields) GetActions() []string

GetActions returns PrincipalGrantFields.Actions, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetCreatedAt added in v0.7.0 

func (v *PrincipalGrantFields) GetCreatedAt() string

GetCreatedAt returns PrincipalGrantFields.CreatedAt, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetExpiresAt added in v0.7.0 

func (v *PrincipalGrantFields) GetExpiresAt() *string

GetExpiresAt returns PrincipalGrantFields.ExpiresAt, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetId added in v0.7.0 

func (v *PrincipalGrantFields) GetId() string

GetId returns PrincipalGrantFields.Id, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetOrganizationId added in v0.7.0 

func (v *PrincipalGrantFields) GetOrganizationId() string

GetOrganizationId returns PrincipalGrantFields.OrganizationId, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetOrganizationUrn added in v0.7.0 

func (v *PrincipalGrantFields) GetOrganizationUrn() *string

GetOrganizationUrn returns PrincipalGrantFields.OrganizationUrn, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetPrincipalHandle added in v0.7.0 

func (v *PrincipalGrantFields) GetPrincipalHandle() *string

GetPrincipalHandle returns PrincipalGrantFields.PrincipalHandle, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetPrincipalId added in v0.7.0 

func (v *PrincipalGrantFields) GetPrincipalId() string

GetPrincipalId returns PrincipalGrantFields.PrincipalId, and is useful for accessing the field via an interface.

func (*PrincipalGrantFields) GetPrincipalType added in v0.7.0 

func (v *PrincipalGrantFields) GetPrincipalType() string

GetPrincipalType returns PrincipalGrantFields.PrincipalType, and is useful for accessing the field via an interface.

type PrincipalGrantsPrincipalGrantsPrincipalGrantsPage added in v0.7.0 

type PrincipalGrantsPrincipalGrantsPrincipalGrantsPage struct {
	Total int                                                                     `json:"total"`
	Items []*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant `json:"items"`
}

PrincipalGrantsPrincipalGrantsPrincipalGrantsPage includes the requested fields of the GraphQL type PrincipalGrantsPage.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPage) GetItems added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPage) GetItems() []*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant

GetItems returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPage.Items, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPage) GetTotal added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPage) GetTotal() int

GetTotal returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPage.Total, and is useful for accessing the field via an interface.

type PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant added in v0.7.0 

type PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant struct {
	PrincipalGrantFields `json:"-"`
}

PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant includes the requested fields of the GraphQL type PrincipalGrant. The GraphQL type's documentation follows.

An individual action grant (design:grant-model): extra management actions for one member of one org, on top of their role bundle. Grantee and org are projected as scalars, never nested objects.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetActions added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetActions() []string

GetActions returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.Actions, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetCreatedAt added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetCreatedAt() string

GetCreatedAt returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.CreatedAt, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetExpiresAt added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetExpiresAt() *string

GetExpiresAt returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.ExpiresAt, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetId added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetId() string

GetId returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.Id, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetOrganizationId added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetOrganizationId() string

GetOrganizationId returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.OrganizationId, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetOrganizationUrn added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetOrganizationUrn() *string

GetOrganizationUrn returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.OrganizationUrn, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetPrincipalHandle added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetPrincipalHandle() *string

GetPrincipalHandle returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.PrincipalHandle, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetPrincipalId added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetPrincipalId() string

GetPrincipalId returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.PrincipalId, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetPrincipalType added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) GetPrincipalType() string

GetPrincipalType returns PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant.PrincipalType, and is useful for accessing the field via an interface.

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) MarshalJSON added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) MarshalJSON() ([]byte, error)

func (*PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) UnmarshalJSON added in v0.7.0 

func (v *PrincipalGrantsPrincipalGrantsPrincipalGrantsPageItemsPrincipalGrant) UnmarshalJSON(b []byte) error

type PrincipalGrantsResponse added in v0.7.0 

type PrincipalGrantsResponse struct {
	// Action grants. Default: the caller's own (self-audit is never gated). An org admin passing orgRef sees that org's grants, optionally narrowed by userRef.
	PrincipalGrants *PrincipalGrantsPrincipalGrantsPrincipalGrantsPage `json:"principalGrants"`
}

PrincipalGrantsResponse is returned by PrincipalGrants on success.

func PrincipalGrants added in v0.7.0 

func PrincipalGrants(
	ctx_ context.Context,
	client_ graphql.Client,
	orgRef *string,
	userRef *string,
	limit *int,
	offset *int,
) (data_ *PrincipalGrantsResponse, err_ error)

Action grants. Default scope: the caller's own (self-audit is never gated). An org admin passing orgRef sees that org's grants, optionally narrowed by userRef. Paged { items, total }.

func (*PrincipalGrantsResponse) GetPrincipalGrants added in v0.7.0 

func (v *PrincipalGrantsResponse) GetPrincipalGrants() *PrincipalGrantsPrincipalGrantsPrincipalGrantsPage

GetPrincipalGrants returns PrincipalGrantsResponse.PrincipalGrants, and is useful for accessing the field via an interface.

type PrincipalType added in v0.7.0 

type PrincipalType string

The kind of principal a credential resolved to (issue #562). USER covers both JWT sessions and hdr_user_ personal API keys; APP is an hdr_app_ key. AGENT is reserved for a future agent-credential principal — no auth path produces it today. 

const (
	PrincipalTypeAgent PrincipalType = "AGENT"
	PrincipalTypeApp   PrincipalType = "APP"
	PrincipalTypeUser  PrincipalType = "USER"
)

type PublicAgentFilter added in v0.9.0 

type PublicAgentFilter struct {
	Type *AgentType `json:"type"`
}

Filter for the publicAgents() marketplace slice (#551). ONLY 'type' narrows. Deliberately a SEPARATE, narrower input from AgentFilter: the slice is PUBLIC by definition (so 'visibility' is meaningless) and a PUBLIC agent is never user-owned (user-owned agents are strictly PERSONAL, spec 047), so an 'ownedByMe' here would always be empty — rejecting it at the schema keeps a client from applying the filter uniformly and silently getting cross-org marketplace agents (#782 Codex review).

func (*PublicAgentFilter) GetType added in v0.9.0 

func (v *PublicAgentFilter) GetType() *AgentType

GetType returns PublicAgentFilter.Type, and is useful for accessing the field via an interface.

type PublicAgentsPublicAgentsAgentsPage added in v0.7.0 

type PublicAgentsPublicAgentsAgentsPage struct {
	Total int                                             `json:"total"`
	Items []*PublicAgentsPublicAgentsAgentsPageItemsAgent `json:"items"`
}

PublicAgentsPublicAgentsAgentsPage includes the requested fields of the GraphQL type AgentsPage.

func (*PublicAgentsPublicAgentsAgentsPage) GetItems added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPage) GetItems() []*PublicAgentsPublicAgentsAgentsPageItemsAgent

GetItems returns PublicAgentsPublicAgentsAgentsPage.Items, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPage) GetTotal added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPage) GetTotal() int

GetTotal returns PublicAgentsPublicAgentsAgentsPage.Total, and is useful for accessing the field via an interface.

type PublicAgentsPublicAgentsAgentsPageItemsAgent added in v0.7.0 

type PublicAgentsPublicAgentsAgentsPageItemsAgent struct {
	AgentFields `json:"-"`
}

PublicAgentsPublicAgentsAgentsPageItemsAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetAiModel added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetAiModel() *string

GetAiModel returns PublicAgentsPublicAgentsAgentsPageItemsAgent.AiModel, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetAiProvider added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetAiProvider() *string

GetAiProvider returns PublicAgentsPublicAgentsAgentsPageItemsAgent.AiProvider, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetCreatedAt added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetCreatedAt() string

GetCreatedAt returns PublicAgentsPublicAgentsAgentsPageItemsAgent.CreatedAt, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetDescription added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetDescription() *string

GetDescription returns PublicAgentsPublicAgentsAgentsPageItemsAgent.Description, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetHasAiApiKey added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetHasAiApiKey() bool

GetHasAiApiKey returns PublicAgentsPublicAgentsAgentsPageItemsAgent.HasAiApiKey, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetId added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetId() string

GetId returns PublicAgentsPublicAgentsAgentsPageItemsAgent.Id, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetName added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetName() string

GetName returns PublicAgentsPublicAgentsAgentsPageItemsAgent.Name, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetOrganizationId added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetOrganizationId() *string

GetOrganizationId returns PublicAgentsPublicAgentsAgentsPageItemsAgent.OrganizationId, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetPersonaRole added in v0.9.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetPersonaRole() *string

GetPersonaRole returns PublicAgentsPublicAgentsAgentsPageItemsAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetSurfaces added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetSurfaces() []string

GetSurfaces returns PublicAgentsPublicAgentsAgentsPageItemsAgent.Surfaces, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetSystemMemoryId added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetSystemMemoryId() *string

GetSystemMemoryId returns PublicAgentsPublicAgentsAgentsPageItemsAgent.SystemMemoryId, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetSystemPrompt added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetSystemPrompt() *string

GetSystemPrompt returns PublicAgentsPublicAgentsAgentsPageItemsAgent.SystemPrompt, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetType added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetType() AgentType

GetType returns PublicAgentsPublicAgentsAgentsPageItemsAgent.Type, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetUrn added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetUrn() string

GetUrn returns PublicAgentsPublicAgentsAgentsPageItemsAgent.Urn, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) GetVisibility added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetVisibility() AgentVisibility

GetVisibility returns PublicAgentsPublicAgentsAgentsPageItemsAgent.Visibility, and is useful for accessing the field via an interface.

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) MarshalJSON added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) MarshalJSON() ([]byte, error)

func (*PublicAgentsPublicAgentsAgentsPageItemsAgent) UnmarshalJSON added in v0.7.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) UnmarshalJSON(b []byte) error

type PublicAgentsResponse added in v0.7.0 

type PublicAgentsResponse struct {
	// #551 — the public-agent marketplace slice: every live PUBLIC agent,
	// readable by ANY caller (no membership required), so an org can discover
	// foreign public agents to subscribe to (008/009 AgentOrgGrant;
	// hadron-portal#486). Kept SEPARATE from agents() on purpose: agents() stays
	// bounded to the caller's own orgs, and the cross-org widening is this
	// explicit, paginated surface rather than a value in a filter.
	//
	// filter.type narrows by AgentType; filter.visibility is IGNORED (the slice
	// is PUBLIC by definition).
	//
	// Field-level exposure: a PUBLIC agent publishes its OWN definition
	// (systemPrompt / systemMemoryId / memoryItems / imports) to every caller —
	// that is what a marketplace listing is (#551). The fields that surface OTHER
	// tenants (apps / appAgents / appCount / orgGrants / importedBy) are scoped to
	// the caller's own access and come back empty for an outsider (#552, #757).
	//
	// Name-ascending order (id tiebreak); limit default 50 / cap 200;
	// limit: 0 -> count only.
	PublicAgents *PublicAgentsPublicAgentsAgentsPage `json:"publicAgents"`
}

PublicAgentsResponse is returned by PublicAgents on success.

func PublicAgents added in v0.7.0 

func PublicAgents(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *PublicAgentFilter,
	limit *int,
	offset *int,
) (data_ *PublicAgentsResponse, err_ error)

The cross-org marketplace slice (#551/#552): every live PUBLIC agent, readable without org membership. A deliberately separate surface from agents() (which stays member-scoped), not a visibility filter on it — backs `agent ls --public`.

Its filter is a separate, narrower input than agents()' AgentFilter: only `type` narrows. The slice is PUBLIC by definition (so `visibility` is meaningless) and a PUBLIC agent is never user-owned (so `ownedByMe` would always be empty) — the server rejects both at the schema rather than letting a client apply AgentFilter uniformly and silently get cross-org agents back.

func (*PublicAgentsResponse) GetPublicAgents added in v0.7.0 

func (v *PublicAgentsResponse) GetPublicAgents() *PublicAgentsPublicAgentsAgentsPage

GetPublicAgents returns PublicAgentsResponse.PublicAgents, and is useful for accessing the field via an interface.

type PublicOrganizationPublicOrganization added in v0.9.0 

type PublicOrganizationPublicOrganization struct {
	Id                  string `json:"id"`
	Urn                 string `json:"urn"`
	Name                string `json:"name"`
	ListedOnMarketplace bool   `json:"listedOnMarketplace"`
	// The org's PUBLIC, non-app-scoped memories (sanitized refs).
	PublicMemories []*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef `json:"publicMemories"`
	// The org's PUBLIC agents (sanitized refs).
	PublicAgents []*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef `json:"publicAgents"`
}

PublicOrganizationPublicOrganization includes the requested fields of the GraphQL type PublicOrganization. The GraphQL type's documentation follows.

cor:acl:080:02 — a sanitized, non-member-safe view of a DISCOVERABLE org. Deliberately a SEPARATE type from Organization: it exposes only public identity + the org's public footprint, never members / private memories / apps / credentials (which the full Organization's nested resolvers would leak).

func (*PublicOrganizationPublicOrganization) GetId added in v0.9.0 

func (v *PublicOrganizationPublicOrganization) GetId() string

GetId returns PublicOrganizationPublicOrganization.Id, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganization) GetListedOnMarketplace added in v0.9.0 

func (v *PublicOrganizationPublicOrganization) GetListedOnMarketplace() bool

GetListedOnMarketplace returns PublicOrganizationPublicOrganization.ListedOnMarketplace, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganization) GetName added in v0.9.0 

func (v *PublicOrganizationPublicOrganization) GetName() string

GetName returns PublicOrganizationPublicOrganization.Name, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganization) GetPublicAgents added in v0.9.0 

func (v *PublicOrganizationPublicOrganization) GetPublicAgents() []*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef

GetPublicAgents returns PublicOrganizationPublicOrganization.PublicAgents, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganization) GetPublicMemories added in v0.9.0 

func (v *PublicOrganizationPublicOrganization) GetPublicMemories() []*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef

GetPublicMemories returns PublicOrganizationPublicOrganization.PublicMemories, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganization) GetUrn added in v0.9.0 

func (v *PublicOrganizationPublicOrganization) GetUrn() string

GetUrn returns PublicOrganizationPublicOrganization.Urn, and is useful for accessing the field via an interface.

type PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef added in v0.9.0 

type PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef struct {
	PublicResourceRefFields `json:"-"`
}

PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef includes the requested fields of the GraphQL type PublicResourceRef. The GraphQL type's documentation follows.

A minimal, safe reference to a public resource (marketplace / discovery).

func (*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetDescription added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetDescription() *string

GetDescription returns PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef.Description, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetId added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetId() string

GetId returns PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef.Id, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetName added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetName() string

GetName returns PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef.Name, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetUrn added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) GetUrn() string

GetUrn returns PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef.Urn, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) MarshalJSON added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) MarshalJSON() ([]byte, error)

func (*PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) UnmarshalJSON added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicAgentsPublicResourceRef) UnmarshalJSON(b []byte) error

type PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef added in v0.9.0 

type PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef struct {
	PublicResourceRefFields `json:"-"`
}

PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef includes the requested fields of the GraphQL type PublicResourceRef. The GraphQL type's documentation follows.

A minimal, safe reference to a public resource (marketplace / discovery).

func (*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetDescription added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetDescription() *string

GetDescription returns PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef.Description, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetId added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetId() string

GetId returns PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef.Id, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetName added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetName() string

GetName returns PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef.Name, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetUrn added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) GetUrn() string

GetUrn returns PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef.Urn, and is useful for accessing the field via an interface.

func (*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) MarshalJSON added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) MarshalJSON() ([]byte, error)

func (*PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) UnmarshalJSON added in v0.9.0 

func (v *PublicOrganizationPublicOrganizationPublicMemoriesPublicResourceRef) UnmarshalJSON(b []byte) error

type PublicOrganizationResponse added in v0.9.0 

type PublicOrganizationResponse struct {
	// cor:acl:080:02 — the sanitized PUBLIC view of a DISCOVERABLE organization,
	// safe for a non-member. Returns non-null only when the org exposes a public
	// footprint (a PUBLIC memory/agent, or listedOnMarketplace); otherwise null
	// (denied is indistinguishable from not-found — anti-enumeration). Never
	// exposes members, private memories, apps, or credentials. 'ref' accepts the
	// org ID or URN.
	PublicOrganization *PublicOrganizationPublicOrganization `json:"publicOrganization"`
}

PublicOrganizationResponse is returned by PublicOrganization on success.

func PublicOrganization added in v0.9.0 

func PublicOrganization(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *PublicOrganizationResponse, err_ error)

func (*PublicOrganizationResponse) GetPublicOrganization added in v0.9.0 

func (v *PublicOrganizationResponse) GetPublicOrganization() *PublicOrganizationPublicOrganization

GetPublicOrganization returns PublicOrganizationResponse.PublicOrganization, and is useful for accessing the field via an interface.

type PublicResourceRefFields added in v0.9.0 

type PublicResourceRefFields struct {
	Id          string  `json:"id"`
	Name        string  `json:"name"`
	Urn         string  `json:"urn"`
	Description *string `json:"description"`
}

publicOrganization returns the sanitized, non-member-safe view of a DISCOVERABLE organization (activated + a public footprint), or null when the org isn't discoverable — the server collapses not-found and not-discoverable to null for anti-enumeration. `$ref` accepts an org id or URN. Surfaced by `hadron org public`. Spec cor:acl:080:02 (#270 / hadron-server#741).

func (*PublicResourceRefFields) GetDescription added in v0.9.0 

func (v *PublicResourceRefFields) GetDescription() *string

GetDescription returns PublicResourceRefFields.Description, and is useful for accessing the field via an interface.

func (*PublicResourceRefFields) GetId added in v0.9.0 

func (v *PublicResourceRefFields) GetId() string

GetId returns PublicResourceRefFields.Id, and is useful for accessing the field via an interface.

func (*PublicResourceRefFields) GetName added in v0.9.0 

func (v *PublicResourceRefFields) GetName() string

GetName returns PublicResourceRefFields.Name, and is useful for accessing the field via an interface.

func (*PublicResourceRefFields) GetUrn added in v0.9.0 

func (v *PublicResourceRefFields) GetUrn() string

GetUrn returns PublicResourceRefFields.Urn, and is useful for accessing the field via an interface.

type RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem added in v0.18.0 

type RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem struct {
	TeamWorkItemLegacyFields `json:"-"`
}

RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem includes the requested fields of the GraphQL type TeamWorkItem. The GraphQL type's documentation follows.

One team-worklog record (#947) — an externally visible work milestone (a PR opened, a branch pushed, an issue closed), append-only. The worklog is the AUTHORITATIVE PR-session join (spec cor:agt:020:03); Session.prNumber is a latest-wins display convenience. ref carries the ONE canonical spelling per artifact (github: owner/repo#N, owner/repo@sha, owner/repo:branch, owner/repo; owner/repo lowercased).

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetAction added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetAction() string

GetAction returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.Action, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetAt added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetAt() string

GetAt returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.At, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetDetail added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetDetail() *json.RawMessage

GetDetail returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.Detail, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetKind added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetKind() string

GetKind returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.Kind, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetNodeId added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetNodeId() string

GetNodeId returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.NodeId, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetRef added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetRef() string

GetRef returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.Ref, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetSessionId added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetSessionId() string

GetSessionId returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.SessionId, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetTool added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetTool() string

GetTool returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.Tool, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetWorkerId added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetWorkerId() *string

GetWorkerId returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.WorkerId, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetWorkerName added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) GetWorkerName() string

GetWorkerName returns RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem.WorkerName, and is useful for accessing the field via an interface.

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) MarshalJSON added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) MarshalJSON() ([]byte, error)

func (*RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) UnmarshalJSON added in v0.18.0 

func (v *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem) UnmarshalJSON(b []byte) error

type RecordTeamWorkLegacyResponse added in v0.18.0 

type RecordTeamWorkLegacyResponse struct {
	// Record an externally visible work milestone into the team App's worklog
	// (#947) — the append-only, authoritative PR-session join (spec
	// cor:agt:020:03). The session must be writable by the caller and a session
	// OF this App (SessionInput.appRef, #944); an ENDED session is accepted —
	// late attribution (a merge lands after the session ends) is the point.
	// ref accepts URL and short spellings and is stored in ONE canonical form
	// (github: owner/repo#N, owner/repo@sha, owner/repo:branch, owner/repo);
	// a bare number is refused — the server never infers a repo. kind must be
	// one of pr, issue, commit, branch, repo; action is a free lowercased verb
	// (opened, merged, claimed, reviewed, closed, pushed, ...). kind: pr also
	// denormalizes the latest-wins Session.prNumber display convenience.
	// detail is an optional JSON bag of display extras (title, URL) — stored,
	// never filtered on. Records are append-only: correct a wrong record by
	// recording a newer one.
	//
	// Authorization: an AppMember of the App (any role), an org member with
	// CONTRIBUTOR+ on the App's org, or the owner of a user-owned App. A pure
	// App-key principal may NOT record (read-only on the worklog).
	//
	// A worker-bound session records under its Worker's name (#974,
	// cor:agt:020:05) — the worker must belong to THIS App and not be retired
	// (SESSION_WORKER_NOT_IN_APP / WORKER_RETIRED — a retired or foreign
	// worker refuses rather than reshaping the attribution); an unbound
	// session records under the attributed user's handle.
	//
	// Typed refusals: WORK_REF_INVALID, SESSION_NOT_FOUND, SESSION_NOT_IN_APP,
	// SESSION_WORKER_NOT_IN_APP, WORKER_RETIRED, TEAM_AGENT_NOT_FOUND /
	// TEAM_AGENT_AMBIGUOUS (first-write bootstrap could not locate the Team
	// Agent), APP_UNINSTALLED, FORBIDDEN, BAD_USER_INPUT.
	//
	// appRef accepts the entity's ID or URN; sessionRef is the session id.
	RecordTeamWork *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem `json:"recordTeamWork"`
}

RecordTeamWorkLegacyResponse is returned by RecordTeamWorkLegacy on success.

func RecordTeamWorkLegacy added in v0.18.0 

func RecordTeamWorkLegacy(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	sessionRef string,
	tool string,
	kind string,
	ref string,
	action string,
	detail *json.RawMessage,
) (data_ *RecordTeamWorkLegacyResponse, err_ error)

func (*RecordTeamWorkLegacyResponse) GetRecordTeamWork added in v0.18.0 

func (v *RecordTeamWorkLegacyResponse) GetRecordTeamWork() *RecordTeamWorkLegacyRecordTeamWorkTeamWorkItem

GetRecordTeamWork returns RecordTeamWorkLegacyResponse.RecordTeamWork, and is useful for accessing the field via an interface.

type RecordTeamWorkRecordTeamWorkTeamWorkItem added in v0.9.0 

type RecordTeamWorkRecordTeamWorkTeamWorkItem struct {
	TeamWorkItemFields `json:"-"`
}

RecordTeamWorkRecordTeamWorkTeamWorkItem includes the requested fields of the GraphQL type TeamWorkItem. The GraphQL type's documentation follows.

One team-worklog record (#947) — an externally visible work milestone (a PR opened, a branch pushed, an issue closed), append-only. The worklog is the AUTHORITATIVE PR-session join (spec cor:agt:020:03); Session.prNumber is a latest-wins display convenience. ref carries the ONE canonical spelling per artifact (github: owner/repo#N, owner/repo@sha, owner/repo:branch, owner/repo; owner/repo lowercased).

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetAction added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetAction() string

GetAction returns RecordTeamWorkRecordTeamWorkTeamWorkItem.Action, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetAt added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetAt() string

GetAt returns RecordTeamWorkRecordTeamWorkTeamWorkItem.At, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetDetail added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetDetail() *json.RawMessage

GetDetail returns RecordTeamWorkRecordTeamWorkTeamWorkItem.Detail, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetKind added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetKind() string

GetKind returns RecordTeamWorkRecordTeamWorkTeamWorkItem.Kind, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetModel added in v0.18.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetModel() *string

GetModel returns RecordTeamWorkRecordTeamWorkTeamWorkItem.Model, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetNodeId added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetNodeId() string

GetNodeId returns RecordTeamWorkRecordTeamWorkTeamWorkItem.NodeId, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetRef added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetRef() string

GetRef returns RecordTeamWorkRecordTeamWorkTeamWorkItem.Ref, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetSessionId added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetSessionId() string

GetSessionId returns RecordTeamWorkRecordTeamWorkTeamWorkItem.SessionId, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetTool added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetTool() string

GetTool returns RecordTeamWorkRecordTeamWorkTeamWorkItem.Tool, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetWorkerId added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetWorkerId() *string

GetWorkerId returns RecordTeamWorkRecordTeamWorkTeamWorkItem.WorkerId, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) GetWorkerName added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) GetWorkerName() string

GetWorkerName returns RecordTeamWorkRecordTeamWorkTeamWorkItem.WorkerName, and is useful for accessing the field via an interface.

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) MarshalJSON added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) MarshalJSON() ([]byte, error)

func (*RecordTeamWorkRecordTeamWorkTeamWorkItem) UnmarshalJSON added in v0.9.0 

func (v *RecordTeamWorkRecordTeamWorkTeamWorkItem) UnmarshalJSON(b []byte) error

type RecordTeamWorkResponse added in v0.9.0 

type RecordTeamWorkResponse struct {
	// Record an externally visible work milestone into the team App's worklog
	// (#947) — the append-only, authoritative PR-session join (spec
	// cor:agt:020:03). The session must be writable by the caller and a session
	// OF this App (SessionInput.appRef, #944); an ENDED session is accepted —
	// late attribution (a merge lands after the session ends) is the point.
	// ref accepts URL and short spellings and is stored in ONE canonical form
	// (github: owner/repo#N, owner/repo@sha, owner/repo:branch, owner/repo);
	// a bare number is refused — the server never infers a repo. kind must be
	// one of pr, issue, commit, branch, repo; action is a free lowercased verb
	// (opened, merged, claimed, reviewed, closed, pushed, ...). kind: pr also
	// denormalizes the latest-wins Session.prNumber display convenience.
	// detail is an optional JSON bag of display extras (title, URL) — stored,
	// never filtered on. Records are append-only: correct a wrong record by
	// recording a newer one.
	//
	// Authorization: an AppMember of the App (any role), an org member with
	// CONTRIBUTOR+ on the App's org, or the owner of a user-owned App. A pure
	// App-key principal may NOT record (read-only on the worklog).
	//
	// A worker-bound session records under its Worker's name (#974,
	// cor:agt:020:05) — the worker must belong to THIS App and not be retired
	// (SESSION_WORKER_NOT_IN_APP / WORKER_RETIRED — a retired or foreign
	// worker refuses rather than reshaping the attribution); an unbound
	// session records under the attributed user's handle.
	//
	// Typed refusals: WORK_REF_INVALID, SESSION_NOT_FOUND, SESSION_NOT_IN_APP,
	// SESSION_WORKER_NOT_IN_APP, WORKER_RETIRED, TEAM_AGENT_NOT_FOUND /
	// TEAM_AGENT_AMBIGUOUS (first-write bootstrap could not locate the Team
	// Agent), APP_UNINSTALLED, FORBIDDEN, BAD_USER_INPUT.
	//
	// appRef accepts the entity's ID or URN; sessionRef is the session id.
	RecordTeamWork *RecordTeamWorkRecordTeamWorkTeamWorkItem `json:"recordTeamWork"`
}

RecordTeamWorkResponse is returned by RecordTeamWork on success.

func RecordTeamWork added in v0.9.0 

func RecordTeamWork(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	sessionRef string,
	tool string,
	kind string,
	ref string,
	action string,
	detail *json.RawMessage,
	model *string,
) (data_ *RecordTeamWorkResponse, err_ error)

func (*RecordTeamWorkResponse) GetRecordTeamWork added in v0.9.0 

func (v *RecordTeamWorkResponse) GetRecordTeamWork() *RecordTeamWorkRecordTeamWorkTeamWorkItem

GetRecordTeamWork returns RecordTeamWorkResponse.RecordTeamWork, and is useful for accessing the field via an interface.

type RegisterEntriesRegisterEntriesRegisterEntriesPage added in v0.15.0 

type RegisterEntriesRegisterEntriesRegisterEntriesPage struct {
	Total int                                                                    `json:"total"`
	Items []*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry `json:"items"`
}

RegisterEntriesRegisterEntriesRegisterEntriesPage includes the requested fields of the GraphQL type RegisterEntriesPage.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPage) GetItems added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPage) GetItems() []*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry

GetItems returns RegisterEntriesRegisterEntriesRegisterEntriesPage.Items, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPage) GetTotal added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPage) GetTotal() int

GetTotal returns RegisterEntriesRegisterEntriesRegisterEntriesPage.Total, and is useful for accessing the field via an interface.

type RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry added in v0.15.0 

type RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry struct {
	RegisterEntryFields `json:"-"`
}

RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry includes the requested fields of the GraphQL type RegisterEntry. The GraphQL type's documentation follows.

A REGISTER ENTRY (spec 049, D-2026-09-13-007): "this attendee takes part in this Channel". The attendee is a Worker when cast, otherwise an Agent in an App; both null = every attendee in the owner's context (org-wide for an organization row, App-wide for an App row). Not a trigger list — a row never starts a run. The register never grants: what the attendee may read or post is the Channel's host memory's decision. Not exportable.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetAttendeeUrn added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetAttendeeUrn() *string

GetAttendeeUrn returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.AttendeeUrn, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetChannelId added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetChannelId() string

GetChannelId returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.ChannelId, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetCreatedAt added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetCreatedAt() string

GetCreatedAt returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.CreatedAt, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetDescription added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetDescription() *string

GetDescription returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.Description, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetId added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetId() string

GetId returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.Id, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetInstallDefault added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetInstallDefault() bool

GetInstallDefault returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.InstallDefault, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetMentionOnly added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetMentionOnly() bool

GetMentionOnly returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.MentionOnly, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetOrganizationId added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetOrganizationId() *string

GetOrganizationId returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.OrganizationId, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetOwnerId added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetOwnerId() string

GetOwnerId returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.OwnerId, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetOwnerType added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetOwnerType() RegisterOwnerType

GetOwnerType returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.OwnerType, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetRole added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetRole() RegisterRole

GetRole returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.Role, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetUpdatedAt added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) GetUpdatedAt() *string

GetUpdatedAt returns RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry.UpdatedAt, and is useful for accessing the field via an interface.

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) MarshalJSON added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) MarshalJSON() ([]byte, error)

func (*RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) UnmarshalJSON added in v0.15.0 

func (v *RegisterEntriesRegisterEntriesRegisterEntriesPageItemsRegisterEntry) UnmarshalJSON(b []byte) error

type RegisterEntriesResponse added in v0.15.0 

type RegisterEntriesResponse struct {
	// Spec 049 Phase 5 — register entries you may read (§8.6), narrowed by owner
	// (an App or an organization), Channel, or attendee (a Worker or an Agent),
	// and by the cor:api:100:01 orgId. A filter naming something foreign returns
	// the same empty page as one naming nothing. Oldest first; limit default 50 / cap 200.
	RegisterEntries *RegisterEntriesRegisterEntriesRegisterEntriesPage `json:"registerEntries"`
}

RegisterEntriesResponse is returned by RegisterEntries on success.

func RegisterEntries added in v0.15.0 

func RegisterEntries(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *RegisterEntryFilter,
	limit *int,
	offset *int,
	orgId *string,
) (data_ *RegisterEntriesResponse, err_ error)

A ref naming nothing MATCHES NOTHING rather than erroring (the server's own wording), so an empty page is ambiguous: no rows, or a filter typo. The command says so on stderr rather than printing an empty table that reads as "nobody is registered".

func (*RegisterEntriesResponse) GetRegisterEntries added in v0.15.0 

func (v *RegisterEntriesResponse) GetRegisterEntries() *RegisterEntriesRegisterEntriesRegisterEntriesPage

GetRegisterEntries returns RegisterEntriesResponse.RegisterEntries, and is useful for accessing the field via an interface.

type RegisterEntryFields added in v0.15.0 

type RegisterEntryFields struct {
	Id        string `json:"id"`
	ChannelId string `json:"channelId"`
	// The attendee's URN (hrn:worker:… or the Agent's); null for 'every attendee'.
	AttendeeUrn *string      `json:"attendeeUrn"`
	Role        RegisterRole `json:"role"`
	// Only messages mentioning the attendee count as new for it.
	MentionOnly bool `json:"mentionOnly"`
	// The row install materialised for the App's default Channel (D2).
	InstallDefault bool `json:"installDefault"`
	// The human's intent, free text.
	Description *string           `json:"description"`
	OwnerType   RegisterOwnerType `json:"ownerType"`
	// ID of the owning organization / App.
	OwnerId        string  `json:"ownerId"`
	OrganizationId *string `json:"organizationId"`
	CreatedAt      string  `json:"createdAt"`
	UpdatedAt      *string `json:"updatedAt"`
}

RegisterEntryFields includes the GraphQL fields of RegisterEntry requested by the fragment RegisterEntryFields. The GraphQL type's documentation follows.

A REGISTER ENTRY (spec 049, D-2026-09-13-007): "this attendee takes part in this Channel". The attendee is a Worker when cast, otherwise an Agent in an App; both null = every attendee in the owner's context (org-wide for an organization row, App-wide for an App row). Not a trigger list — a row never starts a run. The register never grants: what the attendee may read or post is the Channel's host memory's decision. Not exportable.

func (*RegisterEntryFields) GetAttendeeUrn added in v0.15.0 

func (v *RegisterEntryFields) GetAttendeeUrn() *string

GetAttendeeUrn returns RegisterEntryFields.AttendeeUrn, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetChannelId added in v0.15.0 

func (v *RegisterEntryFields) GetChannelId() string

GetChannelId returns RegisterEntryFields.ChannelId, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetCreatedAt added in v0.15.0 

func (v *RegisterEntryFields) GetCreatedAt() string

GetCreatedAt returns RegisterEntryFields.CreatedAt, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetDescription added in v0.15.0 

func (v *RegisterEntryFields) GetDescription() *string

GetDescription returns RegisterEntryFields.Description, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetId added in v0.15.0 

func (v *RegisterEntryFields) GetId() string

GetId returns RegisterEntryFields.Id, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetInstallDefault added in v0.15.0 

func (v *RegisterEntryFields) GetInstallDefault() bool

GetInstallDefault returns RegisterEntryFields.InstallDefault, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetMentionOnly added in v0.15.0 

func (v *RegisterEntryFields) GetMentionOnly() bool

GetMentionOnly returns RegisterEntryFields.MentionOnly, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetOrganizationId added in v0.15.0 

func (v *RegisterEntryFields) GetOrganizationId() *string

GetOrganizationId returns RegisterEntryFields.OrganizationId, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetOwnerId added in v0.15.0 

func (v *RegisterEntryFields) GetOwnerId() string

GetOwnerId returns RegisterEntryFields.OwnerId, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetOwnerType added in v0.15.0 

func (v *RegisterEntryFields) GetOwnerType() RegisterOwnerType

GetOwnerType returns RegisterEntryFields.OwnerType, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetRole added in v0.15.0 

func (v *RegisterEntryFields) GetRole() RegisterRole

GetRole returns RegisterEntryFields.Role, and is useful for accessing the field via an interface.

func (*RegisterEntryFields) GetUpdatedAt added in v0.15.0 

func (v *RegisterEntryFields) GetUpdatedAt() *string

GetUpdatedAt returns RegisterEntryFields.UpdatedAt, and is useful for accessing the field via an interface.

type RegisterEntryFilter added in v0.15.0 

type RegisterEntryFilter struct {
	// A Worker or an Agent.
	AttendeeRef *string `json:"attendeeRef,omitempty"`
	// A Channel: its id or its address (Channel.chatRootUrn). A ref naming nothing matches nothing.
	ChannelRef *string `json:"channelRef,omitempty"`
	// An App or an organization.
	OwnerRef *string `json:"ownerRef,omitempty"`
}

Filter for registerEntries(). Refs: ID or URN.

func (*RegisterEntryFilter) GetAttendeeRef added in v0.15.0 

func (v *RegisterEntryFilter) GetAttendeeRef() *string

GetAttendeeRef returns RegisterEntryFilter.AttendeeRef, and is useful for accessing the field via an interface.

func (*RegisterEntryFilter) GetChannelRef added in v0.15.0 

func (v *RegisterEntryFilter) GetChannelRef() *string

GetChannelRef returns RegisterEntryFilter.ChannelRef, and is useful for accessing the field via an interface.

func (*RegisterEntryFilter) GetOwnerRef added in v0.15.0 

func (v *RegisterEntryFilter) GetOwnerRef() *string

GetOwnerRef returns RegisterEntryFilter.OwnerRef, and is useful for accessing the field via an interface.

type RegisterOwnerType added in v0.15.0 

type RegisterOwnerType string

A register row is owned by exactly one of the two; Agent-owned rows do not exist (plan §14). 

const (
	RegisterOwnerTypeApp          RegisterOwnerType = "APP"
	RegisterOwnerTypeOrganization RegisterOwnerType = "ORGANIZATION"
)

type RegisterRole added in v0.15.0 

type RegisterRole string

What a register row declares: INTENT, never permission (D-2026-09-13-008). 

const (
	RegisterRoleBoth  RegisterRole = "BOTH"
	RegisterRolePost  RegisterRole = "POST"
	RegisterRoleWatch RegisterRole = "WATCH"
)

type ReleaseWorkerReleaseWorkerReleaseWorkerPayload added in v0.13.0 

type ReleaseWorkerReleaseWorkerReleaseWorkerPayload struct {
	// The worker, re-read immediately after the guarded release and BEFORE the
	// team-chat notice — so the interval in which another caller could bind is as
	// narrow as it can be made. It is NOT zero, and this is a re-read rather than
	// a snapshot of the write.
	//
	// So a non-null heldByUserId here is a LATER hold somebody else took, never a
	// failed release. releasedFrom is what says the release happened; this field
	// is current state, and the two answer different questions.
	Worker *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker `json:"worker"`
	// The holder the WRITE ended — not the one a pre-read saw. Null when nothing
	// was released, i.e. the name was already unheld (the idempotent path).
	//
	// This is the value the authorization decision was made against AND the value
	// the guarded write matched on; #1084 made those the same user by
	// construction, so this cannot name somebody other than whoever actually
	// lost the name.
	ReleasedFrom *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser `json:"releasedFrom"`
	// True when the caller released SOMEBODY ELSE'S hold — the admin
	// force-release path, the one act that takes a name without its holder
	// acting, and the one that posts to the team chat.
	//
	// Computed server-side, from the authenticated principal and the hold the
	// write ended in the same transaction. A client computing it would have to
	// compare a value it was given against one it had to fetch, and that fetch
	// fails on exactly the path where the answer matters.
	//
	// false always means the holder was YOU, or that nothing was released
	// (releasedFrom null) — never "the server could not tell".
	Forced bool `json:"forced"`
	// Whether the team-chat notice was posted. THREE states, deliberately:
	//
	// - null — no notice was owed. A self-release, or nothing released.
	// - true — a notice was owed and posted.
	// - false — a notice was OWED AND FAILED. The release still happened; an
	// unreachable chat must not stop an admin recovering a departed
	// colleague's names.
	//
	// A plain boolean would collapse the first and last, and a client cannot
	// render "we may have silently failed to announce this" honestly — so the
	// only truthful UI would be to say nothing, throwing the field away.
	Notified *bool `json:"notified"`
}

ReleaseWorkerReleaseWorkerReleaseWorkerPayload includes the requested fields of the GraphQL type ReleaseWorkerPayload. The GraphQL type's documentation follows.

#1073 — what a releaseWorker call actually DID, rather than what the caller predicted it would do.

releaseWorker used to return the post-release Worker, whose heldByUserId is null by construction — so a client could report only who held the name when it last looked. Per cor:agt:020:09 the two release paths are different ACTS: the holder's own release notifies nobody, an admin force-release must announce itself in the team chat. A receipt that cannot tell them apart describes an act that may not have happened.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetForced added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetForced() bool

GetForced returns ReleaseWorkerReleaseWorkerReleaseWorkerPayload.Forced, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetNotified added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetNotified() *bool

GetNotified returns ReleaseWorkerReleaseWorkerReleaseWorkerPayload.Notified, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetReleasedFrom added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetReleasedFrom() *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser

GetReleasedFrom returns ReleaseWorkerReleaseWorkerReleaseWorkerPayload.ReleasedFrom, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetWorker added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayload) GetWorker() *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker

GetWorker returns ReleaseWorkerReleaseWorkerReleaseWorkerPayload.Worker, and is useful for accessing the field via an interface.

type ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser added in v0.13.0 

type ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser struct {
	Id     string  `json:"id"`
	Handle *string `json:"handle"`
	// Canonical hrn:user:<handle> URN (cor:urn:010:01). Null for a handle-less user.
	Urn *string `json:"urn"`
	// Withheld (null) from a viewer who is not the user themselves, a platform
	// admin, or a co-member of one of their orgs — the SAME #384 gate as
	// User.name, reused rather than restated. An admin releasing a colleague who
	// has left the org sees null here, and still gets id/handle/urn.
	Name *string `json:"name"`
}

ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser includes the requested fields of the GraphQL type ReleasedFromUser. The GraphQL type's documentation follows.

#1073 — a sanitized identity for the person a release took a name FROM.

Deliberately a SEPARATE type from User, on the cor:acl:080:02 / PublicOrganization precedent: a field returning another entity's object hands the caller that entity's field resolvers, and User's default-resolved tail (policy, identityProvider, externalId, githubId, roles, maxReferrals) carries no gate of its own — it relies on the surface that returned it.

releaseWorker cannot lean on that. Its admin path exists for the departed colleague, and leaveApp DELETES the AppMember row while the hold survives — so the very case this path serves is the one where the caller has no other route to that User. Worker itself only ever exposed heldByUserId, a bare id, so a full User here would be a NEW disclosure rather than an inherited one.

Exposes what answers "who did I release", and nothing that grows back toward User. name keeps the same #384 gate it has on User rather than a second copy of the rule; the rest is public identity a URN already discloses.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetHandle added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetHandle() *string

GetHandle returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser.Handle, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetId added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetId() string

GetId returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser.Id, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetName added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetName() *string

GetName returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser.Name, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetUrn added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser) GetUrn() *string

GetUrn returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadReleasedFromReleasedFromUser.Urn, and is useful for accessing the field via an interface.

type ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker added in v0.13.0 

type ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker struct {
	WorkerFields `json:"-"`
}

ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetAgentId added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetAgentId() string

GetAgentId returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.AgentId, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetAppId added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetAppId() string

GetAppId returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.AppId, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetCreatedAt added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetCreatedAt() string

GetCreatedAt returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.CreatedAt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetCreatedBy added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetCreatedBy() *string

GetCreatedBy returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.CreatedBy, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetHasLiveSession added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetHasLiveSession() *bool

GetHasLiveSession returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.HasLiveSession, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetHeldAt added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetHeldAt() *string

GetHeldAt returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.HeldAt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetHeldByUserId added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetHeldByUserId() *string

GetHeldByUserId returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetId added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetId() string

GetId returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.Id, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetLastActiveAt added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetLastActiveAt() *string

GetLastActiveAt returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.LastActiveAt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetMemoryId added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetMemoryId() *string

GetMemoryId returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.MemoryId, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetName added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetName() string

GetName returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.Name, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetPortalUrl added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetPortalUrl() *string

GetPortalUrl returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetPrompt added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetPrompt() *string

GetPrompt returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.Prompt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetPromptOverride added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetPromptOverride() *string

GetPromptOverride returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRepos added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRepos() []string

GetRepos returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.Repos, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRetiredAt added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRetiredAt() *string

GetRetiredAt returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRetiredBy added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRetiredBy() *string

GetRetiredBy returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRole added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetRole() *string

GetRole returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.Role, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetSlug added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetSlug() string

GetSlug returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.Slug, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetUrn added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) GetUrn() *string

GetUrn returns ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker.Urn, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) MarshalJSON added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) MarshalJSON() ([]byte, error)

func (*ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) UnmarshalJSON added in v0.13.0 

func (v *ReleaseWorkerReleaseWorkerReleaseWorkerPayloadWorker) UnmarshalJSON(b []byte) error

type ReleaseWorkerResponse added in v0.10.0 

type ReleaseWorkerResponse struct {
	// #1050 — release a HELD name, so somebody else can hold it.
	//
	// A name is held by a person until released; nothing else frees one, which
	// is what makes availability a fact rather than a judgement about whether an
	// idle driver is really gone. Two principals may call this, and they are
	// different acts: the HOLDER, releasing their own name and owing nobody
	// notice; or an App/org ADMIN, force-releasing somebody else's — the path
	// that exists so a departed colleague's names are not held forever.
	//
	// An admin force-release POSTS TO THE TEAM CHAT, naming who released what
	// and from whom, because the incident this model answers is exactly the one
	// where notice was owed and there was no way to give it. Best-effort: an
	// unreachable chat never blocks the release.
	//
	// Releasing does NOT retire the worker, free the name for a different
	// casting, or touch its history — the name stays permanently allocated to
	// this casting, and the handoff sequence and worklog travel with the worker
	// to whoever holds it next. Idempotent: releasing an unheld worker returns
	// it unchanged.
	//
	// #1073 — OPTIONAL PRECONDITION. The two release paths are different acts:
	// the holder's own release notifies nobody, an admin force-release announces
	// itself in the team chat. A client that wants to tell its user which one it
	// is about to perform can only classify from a pre-read, and the hold can
	// change in between — so the act performed differs from the act described,
	// and a hold taken in that interval is force-released silently.
	//
	// State what you expect and the server refuses instead. Pass
	// expectedHolderUserId to assert a specific holder, or expectUnheld: true to
	// assert there is none; a mismatch refuses WORKER_HOLD_STALE carrying the
	// holder actually found. Passing neither keeps the unconditional behaviour,
	// so this is additive. Passing both is BAD_USER_INPUT.
	//
	// Two arguments rather than one nullable id on purpose: distinguishing
	// "expect nobody" from "no expectation" through a nullable argument would
	// rest on KEY PRESENCE, and any layer that forwards the argument
	// unconditionally sends undefined — present, and read as an assertion nobody
	// made. That is a live hazard in this codebase, so a safety precondition does
	// not lean on it.
	ReleaseWorker *ReleaseWorkerReleaseWorkerReleaseWorkerPayload `json:"releaseWorker"`
}

ReleaseWorkerResponse is returned by ReleaseWorker on success.

func ReleaseWorker added in v0.10.0 

func ReleaseWorker(
	ctx_ context.Context,
	client_ graphql.Client,
	workerRef string,
	expectedHolderUserId *string,
	expectUnheld *bool,
) (data_ *ReleaseWorkerResponse, err_ error)

Release the HOLD on a name (hadron-server#1050, cor:agt:020:09) — the ONLY thing that frees one. Two principals, and the SERVER gates both: the HOLDER releasing their own, owing nobody notice; or an App/org ADMIN force-releasing somebody else's, which POSTS TO THE TEAM CHAT, because the incident this model answers is one where notice was owed and there was no way to give it.

The CLI does not reimplement that gate — a client-side authority check would be a second, drifting copy of an access rule. It reads the hold only to say WHICH act the caller is about to perform.

Idempotent: releasing an unheld worker returns it unchanged. The CLI reports that as "no hold was visible to you" rather than "not held" — heldByUserId is masked to null on DENY, so a nil hold READ ON ITS OWN does not distinguish an unheld name from one the caller may not see, and claiming the name is free is what sends a reader into WORKER_HELD at the next session start.

That hedge is now a CHOICE, not a limit, and the distinction matters to whoever edits this next. Since #487 this operation selects hasLiveSession (via WorkerFields), which IS a sound visibility signal — sound for the exact reason #504's retracted probe was not, since that one read fields that are legitimately nullable while this one is never legitimately null on a permitted read. Release still does not consult it: a rendered cell and a refusal-shaped classification are different risks, and #504 retracted two designs in this spot. Adopting it is hadron-cli#522. The PRECONDITION (hadron-server#1084, hadron-cli#522) replaces the re-read this command used to do. State the hold you classified against and the server refuses WORKER_HOLD_STALE if it is not that — enforced BY THE GUARDED WRITE, which takes the asserted value, so there is no check-then-write window left for a client to narrow. The re-read only ever shrank the race to one round trip; this closes it.

Exactly one of the two is ever sent. Both together is BAD_USER_INPUT, and neither is the old unconditional behaviour — which is why both carry omitempty: a nil that went as an explicit `null` would be PRESENT, and `expectUnheld: null` is a different request from omitting it. That is findings:optional-arg-meets-presence-semantics, and the server engineer chose two arguments over one nullable id precisely because presence semantics are a live hazard in this codebase.

func (*ReleaseWorkerResponse) GetReleaseWorker added in v0.10.0 

func (v *ReleaseWorkerResponse) GetReleaseWorker() *ReleaseWorkerReleaseWorkerReleaseWorkerPayload

GetReleaseWorker returns ReleaseWorkerResponse.ReleaseWorker, and is useful for accessing the field via an interface.

type RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload added in v0.3.0 

type RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload struct {
	MemoryId string `json:"memoryId"`
	UserId   string `json:"userId"`
}

RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload includes the requested fields of the GraphQL type RemoveMemoryMemberPayload.

func (*RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload) GetMemoryId added in v0.3.0 

func (v *RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload) GetMemoryId() string

GetMemoryId returns RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload.MemoryId, and is useful for accessing the field via an interface.

func (*RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload) GetUserId added in v0.3.0 

func (v *RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload) GetUserId() string

GetUserId returns RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload.UserId, and is useful for accessing the field via an interface.

type RemoveMemoryMemberResponse added in v0.3.0 

type RemoveMemoryMemberResponse struct {
	// 023-app-shape US4 — remove a team member. Idempotent. Removing
	// the LAST owner is rejected with LastOwnerProtectedError (FR-038)
	// — group memories must always have ≥1 owner; the path to fully
	// empty one is to delete the Memory.
	//
	// Removing the last non-owner does NOT delete the Memory (FR-031);
	// the row persists with its remaining owner(s).
	//
	// Caller-authority: either an owner of the Memory, or the member
	// being removed (self-removal).
	RemoveMemoryMember *RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload `json:"removeMemoryMember"`
}

RemoveMemoryMemberResponse is returned by RemoveMemoryMember on success.

func RemoveMemoryMember added in v0.3.0 

func RemoveMemoryMember(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	userRef string,
) (data_ *RemoveMemoryMemberResponse, err_ error)

func (*RemoveMemoryMemberResponse) GetRemoveMemoryMember added in v0.3.0 

func (v *RemoveMemoryMemberResponse) GetRemoveMemoryMember() *RemoveMemoryMemberRemoveMemoryMemberRemoveMemoryMemberPayload

GetRemoveMemoryMember returns RemoveMemoryMemberResponse.RemoveMemoryMember, and is useful for accessing the field via an interface.

type RemoveOrgMemberResponse added in v0.3.0 

type RemoveOrgMemberResponse struct {
	// Accepts the entity's ID or URN (orgId).
	RemoveOrgMember bool `json:"removeOrgMember"`
}

RemoveOrgMemberResponse is returned by RemoveOrgMember on success.

func RemoveOrgMember added in v0.3.0 

func RemoveOrgMember(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId string,
	userId string,
) (data_ *RemoveOrgMemberResponse, err_ error)

func (*RemoveOrgMemberResponse) GetRemoveOrgMember added in v0.3.0 

func (v *RemoveOrgMemberResponse) GetRemoveOrgMember() bool

GetRemoveOrgMember returns RemoveOrgMemberResponse.RemoveOrgMember, and is useful for accessing the field via an interface.

type RenumberSpecRenumberSpecSpecRenumberResult added in v0.18.0 

type RenumberSpecRenumberSpecSpecRenumberResult struct {
	DryRun        bool                                                                       `json:"dryRun"`
	Moved         []*RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove         `json:"moved"`
	Rewrites      []*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite   `json:"rewrites"`
	TextCitations []*RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation `json:"textCitations"`
}

RenumberSpecRenumberSpecSpecRenumberResult includes the requested fields of the GraphQL type SpecRenumberResult. The GraphQL type's documentation follows.

#1449 — the result (or, with dryRun, the plan) of renumberSpec.

func (*RenumberSpecRenumberSpecSpecRenumberResult) GetDryRun added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResult) GetDryRun() bool

GetDryRun returns RenumberSpecRenumberSpecSpecRenumberResult.DryRun, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResult) GetMoved added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResult) GetMoved() []*RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove

GetMoved returns RenumberSpecRenumberSpecSpecRenumberResult.Moved, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResult) GetRewrites added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResult) GetRewrites() []*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite

GetRewrites returns RenumberSpecRenumberSpecSpecRenumberResult.Rewrites, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResult) GetTextCitations added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResult) GetTextCitations() []*RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation

GetTextCitations returns RenumberSpecRenumberSpecSpecRenumberResult.TextCitations, and is useful for accessing the field via an interface.

type RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove added in v0.18.0 

type RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove struct {
	FromLoc string `json:"fromLoc"`
	ToLoc   string `json:"toLoc"`
}

RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove includes the requested fields of the GraphQL type SpecRenumberMove. The GraphQL type's documentation follows.

#1449 — one spec a renumber moves (the spec or a descendant).

func (*RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove) GetFromLoc added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove) GetFromLoc() string

GetFromLoc returns RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove.FromLoc, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove) GetToLoc added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove) GetToLoc() string

GetToLoc returns RenumberSpecRenumberSpecSpecRenumberResultMovedSpecRenumberMove.ToLoc, and is useful for accessing the field via an interface.

type RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite added in v0.18.0 

type RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite struct {
	NodeId string            `json:"nodeId"`
	Loc    string            `json:"loc"`
	Status SpecRewriteStatus `json:"status"`
	// The text fields rewritten.
	Fields []string `json:"fields"`
	// How many URN references were rewritten.
	Count int     `json:"count"`
	Error *string `json:"error"`
}

RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite includes the requested fields of the GraphQL type SpecRenumberRewrite. The GraphQL type's documentation follows.

#1449 — one node whose URN references a renumber rewrites.

func (*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetCount added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetCount() int

GetCount returns RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite.Count, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetError added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetError() *string

GetError returns RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite.Error, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetFields added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetFields() []string

GetFields returns RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite.Fields, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetLoc added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetLoc() string

GetLoc returns RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite.Loc, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetNodeId added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetNodeId() string

GetNodeId returns RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite.NodeId, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetStatus added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite) GetStatus() SpecRewriteStatus

GetStatus returns RenumberSpecRenumberSpecSpecRenumberResultRewritesSpecRenumberRewrite.Status, and is useful for accessing the field via an interface.

type RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation added in v0.18.0 

type RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation struct {
	SourceNodeId string `json:"sourceNodeId"`
	SourceLoc    string `json:"sourceLoc"`
	Field        string `json:"field"`
	Citation     string `json:"citation"`
	// A short window of text around the citation.
	Excerpt string `json:"excerpt"`
}

RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation includes the requested fields of the GraphQL type SpecTextCitation. The GraphQL type's documentation follows.

#1449 — a moved citation that appears as bare TEXT (a link label, a node name, prose). Reported, never rewritten: it cannot be told apart from other characters in prose.

func (*RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetCitation added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetCitation() string

GetCitation returns RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation.Citation, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetExcerpt added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetExcerpt() string

GetExcerpt returns RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation.Excerpt, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetField added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetField() string

GetField returns RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation.Field, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetSourceLoc added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetSourceLoc() string

GetSourceLoc returns RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation.SourceLoc, and is useful for accessing the field via an interface.

func (*RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetSourceNodeId added in v0.18.0 

func (v *RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation) GetSourceNodeId() string

GetSourceNodeId returns RenumberSpecRenumberSpecSpecRenumberResultTextCitationsSpecTextCitation.SourceNodeId, and is useful for accessing the field via an interface.

type RenumberSpecResponse added in v0.18.0 

type RenumberSpecResponse struct {
	// #1449 — renumber an UNMINTED spec (#1591: draft rights are per node): move
	// it and its subtree from fromLoc to toLoc with no URN alias, refusing
	// NODE_MINTED { locs } if any moved node is minted, then rewrite every node
	// URN in the corpus that cites the moved specs, each as a normal edit. Bare
	// text citations (labels, names) are reported in textCitations, not
	// rewritten. dryRun returns the plan and writes nothing. The move is atomic;
	// each rewrite is a separate guarded edit, and one that fails is reported
	// FAILED without undoing the move.
	RenumberSpec *RenumberSpecRenumberSpecSpecRenumberResult `json:"renumberSpec"`
}

RenumberSpecResponse is returned by RenumberSpec on success.

func RenumberSpec added in v0.18.0 

func RenumberSpec(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	fromLoc string,
	toLoc string,
	dryRun bool,
) (data_ *RenumberSpecResponse, err_ error)

#1449 — renumber a spec (and its subtree) and rewrite the URN references to it. dryRun returns the plan and writes nothing.

func (*RenumberSpecResponse) GetRenumberSpec added in v0.18.0 

func (v *RenumberSpecResponse) GetRenumberSpec() *RenumberSpecRenumberSpecSpecRenumberResult

GetRenumberSpec returns RenumberSpecResponse.RenumberSpec, and is useful for accessing the field via an interface.

type ReserveSpecCitationReserveSpecCitationNode added in v0.18.0 

type ReserveSpecCitationReserveSpecCitationNode struct {
	Id   string `json:"id"`
	Loc  string `json:"loc"`
	Name string `json:"name"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role *string `json:"role"`
	// #1450 — true for a RESERVED spec citation that has no spec written yet (a
	// placeholder in a draft corpus, created by reserveSpecCitation). Set only by
	// the server, never inferred from an empty body; writing real content through
	// updateSpecNode clears it. Minting refuses while any remain.
	IsPlaceholder bool `json:"isPlaceholder"`
}

ReserveSpecCitationReserveSpecCitationNode includes the requested fields of the GraphQL type Node.

func (*ReserveSpecCitationReserveSpecCitationNode) GetId added in v0.18.0 

func (v *ReserveSpecCitationReserveSpecCitationNode) GetId() string

GetId returns ReserveSpecCitationReserveSpecCitationNode.Id, and is useful for accessing the field via an interface.

func (*ReserveSpecCitationReserveSpecCitationNode) GetIsPlaceholder added in v0.18.0 

func (v *ReserveSpecCitationReserveSpecCitationNode) GetIsPlaceholder() bool

GetIsPlaceholder returns ReserveSpecCitationReserveSpecCitationNode.IsPlaceholder, and is useful for accessing the field via an interface.

func (*ReserveSpecCitationReserveSpecCitationNode) GetLoc added in v0.18.0 

func (v *ReserveSpecCitationReserveSpecCitationNode) GetLoc() string

GetLoc returns ReserveSpecCitationReserveSpecCitationNode.Loc, and is useful for accessing the field via an interface.

func (*ReserveSpecCitationReserveSpecCitationNode) GetName added in v0.18.0 

func (v *ReserveSpecCitationReserveSpecCitationNode) GetName() string

GetName returns ReserveSpecCitationReserveSpecCitationNode.Name, and is useful for accessing the field via an interface.

func (*ReserveSpecCitationReserveSpecCitationNode) GetRole added in v0.18.0 

func (v *ReserveSpecCitationReserveSpecCitationNode) GetRole() *string

GetRole returns ReserveSpecCitationReserveSpecCitationNode.Role, and is useful for accessing the field via an interface.

type ReserveSpecCitationResponse added in v0.18.0 

type ReserveSpecCitationResponse struct {
	// #1450 — reserve a citation as a placeholder, in any memory since #1591: an
	// unminted spec node at loc (role spec, nodeType info) marked isPlaceholder,
	// so links can point at it and the placeholders left are the corpus's to-do
	// list. Writing real content through updateSpecNode turns it into a real spec
	// at the same citation; minting refuses while a placeholder remains. Refuses
	// NodeLocConflictError at a live loc. memoryRef accepts the memory's ID or URN.
	ReserveSpecCitation *ReserveSpecCitationReserveSpecCitationNode `json:"reserveSpecCitation"`
}

ReserveSpecCitationResponse is returned by ReserveSpecCitation on success.

func ReserveSpecCitation added in v0.18.0 

func ReserveSpecCitation(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	loc string,
	name *string,
) (data_ *ReserveSpecCitationResponse, err_ error)

#1450 — reserve a citation as a placeholder spec. name is optional: the server names an unnamed placeholder itself.

func (*ReserveSpecCitationResponse) GetReserveSpecCitation added in v0.18.0 

func (v *ReserveSpecCitationResponse) GetReserveSpecCitation() *ReserveSpecCitationReserveSpecCitationNode

GetReserveSpecCitation returns ReserveSpecCitationResponse.ReserveSpecCitation, and is useful for accessing the field via an interface.

type ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig added in v0.2.0 

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; known: 'anthropic' | 'openai' | 'glm' | 'bedrock' | 'openai-compatible' (any OpenAI-wire host; endpoint required).
	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"`
}

ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig includes the requested fields of the GraphQL type AiServiceConfig. The GraphQL type's documentation follows.

036-ai-service-config: a named AI service configuration (masked management view — never carries key material beyond the preview). Owned by exactly one of HadronServer / Organization / App / Agent. Resolution walks App -> Agent -> Org (of the App) -> HadronServer and returns the first ENABLED config with the requested name. Well-known fallback name: 'default' (conventional extras: 'fast', 'frontier'). Name is unique per owner.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetApiKeyPreview added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetApiKeyPreview() *string

GetApiKeyPreview returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetCreatedAt added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetCreatedAt() string

GetCreatedAt returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetEnabled added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetEnabled() bool

GetEnabled returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.Enabled, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetHasApiKey added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetHasApiKey() bool

GetHasApiKey returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.HasApiKey, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetId added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetId() string

GetId returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.Id, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetModel added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetModel() string

GetModel returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.Model, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetName added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetName() string

GetName returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.Name, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetOwnerId added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetOwnerId() string

GetOwnerId returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.OwnerId, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetOwnerType added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetOwnerType() AiConfigOwnerType

GetOwnerType returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.OwnerType, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetParams added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetParams() *json.RawMessage

GetParams returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.Params, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetProvider added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetProvider() string

GetProvider returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.Provider, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetUpdatedAt added in v0.2.0 

func (v *ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig) GetUpdatedAt() *string

GetUpdatedAt returns ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig.UpdatedAt, and is useful for accessing the field via an interface.

type ResolveAiServiceConfigsResponse added in v0.2.0 

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
	// appRef, be a member of that App, and (when an agentRef 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 appRef.
	//
	// appRef/agentRef accept the entity's ID or URN.
	ResolveAiServiceConfigs []*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig `json:"resolveAiServiceConfigs"`
}

ResolveAiServiceConfigsResponse is returned by ResolveAiServiceConfigs on success.

func ResolveAiServiceConfigs added in v0.2.0 

func ResolveAiServiceConfigs(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef *string,
	agentRef *string,
) (data_ *ResolveAiServiceConfigsResponse, err_ error)

func (*ResolveAiServiceConfigsResponse) GetResolveAiServiceConfigs added in v0.2.0 

func (v *ResolveAiServiceConfigsResponse) GetResolveAiServiceConfigs() []*ResolveAiServiceConfigsResolveAiServiceConfigsAiServiceConfig

GetResolveAiServiceConfigs returns ResolveAiServiceConfigsResponse.ResolveAiServiceConfigs, and is useful for accessing the field via an interface.

type ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig added in v0.18.0 

type ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig struct {
	AiServiceConfigEndpointFields `json:"-"`
}

ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig includes the requested fields of the GraphQL type AiServiceConfig. The GraphQL type's documentation follows.

036-ai-service-config: a named AI service configuration (masked management view — never carries key material beyond the preview). Owned by exactly one of HadronServer / Organization / App / Agent. Resolution walks App -> Agent -> Org (of the App) -> HadronServer and returns the first ENABLED config with the requested name. Well-known fallback name: 'default' (conventional extras: 'fast', 'frontier'). Name is unique per owner.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetApiKeyPreview added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetApiKeyPreview() *string

GetApiKeyPreview returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetCreatedAt added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetCreatedAt() string

GetCreatedAt returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetEffectiveEndpoint added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetEffectiveEndpoint() *string

GetEffectiveEndpoint returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.EffectiveEndpoint, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetEnabled added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetEnabled() bool

GetEnabled returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.Enabled, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetEndpoint added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetEndpoint() *string

GetEndpoint returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.Endpoint, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetHasApiKey added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetHasApiKey() bool

GetHasApiKey returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.HasApiKey, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetId added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetId() string

GetId returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.Id, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetModel added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetModel() string

GetModel returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.Model, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetName added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetName() string

GetName returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.Name, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetOwnerId added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetOwnerId() string

GetOwnerId returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.OwnerId, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetOwnerType added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetOwnerType() AiConfigOwnerType

GetOwnerType returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.OwnerType, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetParams added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetParams() *json.RawMessage

GetParams returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.Params, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetProvider added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetProvider() string

GetProvider returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.Provider, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetUpdatedAt added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) GetUpdatedAt() *string

GetUpdatedAt returns ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig.UpdatedAt, and is useful for accessing the field via an interface.

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) MarshalJSON added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) MarshalJSON() ([]byte, error)

func (*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) UnmarshalJSON added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig) UnmarshalJSON(b []byte) error

type ResolveAiServiceConfigsWithEndpointResponse added in v0.18.0 

type ResolveAiServiceConfigsWithEndpointResponse 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
	// appRef, be a member of that App, and (when an agentRef 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 appRef.
	//
	// appRef/agentRef accept the entity's ID or URN.
	ResolveAiServiceConfigs []*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig `json:"resolveAiServiceConfigs"`
}

ResolveAiServiceConfigsWithEndpointResponse is returned by ResolveAiServiceConfigsWithEndpoint on success.

func ResolveAiServiceConfigsWithEndpoint added in v0.18.0 

func ResolveAiServiceConfigsWithEndpoint(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef *string,
	agentRef *string,
) (data_ *ResolveAiServiceConfigsWithEndpointResponse, err_ error)

func (*ResolveAiServiceConfigsWithEndpointResponse) GetResolveAiServiceConfigs added in v0.18.0 

func (v *ResolveAiServiceConfigsWithEndpointResponse) GetResolveAiServiceConfigs() []*ResolveAiServiceConfigsWithEndpointResolveAiServiceConfigsAiServiceConfig

GetResolveAiServiceConfigs returns ResolveAiServiceConfigsWithEndpointResponse.ResolveAiServiceConfigs, and is useful for accessing the field via an interface.

type ResolveUrnResolveUrnUrnResolution 

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

ResolveUrnResolveUrnUrnResolution includes the requested fields of the GraphQL type UrnResolution. The GraphQL type's documentation follows.

Result of resolving a Hadron URN to the ids a client needs to navigate to the resource's canonical page. Powers the portal's /app/u/<urn> redirect route (hadron-portal#262).

`kind` is the URN's type segment: memory | node | agent | org | app | user | apprun | worker | noderev. `id` is the resolved entity's primary id. `memoryId` is set only for nodes (their owning memory), `organizationId` for apps, app runs, and workers (their owning org) — both are the extra ids those resources' canonical routes require.

func (*ResolveUrnResolveUrnUrnResolution) GetId 

func (v *ResolveUrnResolveUrnUrnResolution) GetId() string

GetId returns ResolveUrnResolveUrnUrnResolution.Id, and is useful for accessing the field via an interface.

func (*ResolveUrnResolveUrnUrnResolution) GetKind 

func (v *ResolveUrnResolveUrnUrnResolution) GetKind() string

GetKind returns ResolveUrnResolveUrnUrnResolution.Kind, and is useful for accessing the field via an interface.

func (*ResolveUrnResolveUrnUrnResolution) GetMemoryId 

func (v *ResolveUrnResolveUrnUrnResolution) GetMemoryId() *string

GetMemoryId returns ResolveUrnResolveUrnUrnResolution.MemoryId, and is useful for accessing the field via an interface.

type ResolveUrnResponse 

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
	// (`root:slug` could be a memory or an agent) and resolve to null.
	ResolveUrn *ResolveUrnResolveUrnUrnResolution `json:"resolveUrn"`
}

ResolveUrnResponse is returned by ResolveUrn on success.

func ResolveUrn 

func ResolveUrn(
	ctx_ context.Context,
	client_ graphql.Client,
	urn string,
) (data_ *ResolveUrnResponse, err_ error)

func (*ResolveUrnResponse) GetResolveUrn 

func (v *ResolveUrnResponse) GetResolveUrn() *ResolveUrnResolveUrnUrnResolution

GetResolveUrn returns ResolveUrnResponse.ResolveUrn, and is useful for accessing the field via an interface.

type RestoreAssetResponse added in v0.9.0 

type RestoreAssetResponse struct {
	RestoreAsset *RestoreAssetRestoreAsset `json:"restoreAsset"`
}

RestoreAssetResponse is returned by RestoreAsset on success.

func RestoreAsset added in v0.9.0 

func RestoreAsset(
	ctx_ context.Context,
	client_ graphql.Client,
	assetId string,
) (data_ *RestoreAssetResponse, err_ error)

func (*RestoreAssetResponse) GetRestoreAsset added in v0.9.0 

func (v *RestoreAssetResponse) GetRestoreAsset() *RestoreAssetRestoreAsset

GetRestoreAsset returns RestoreAssetResponse.RestoreAsset, and is useful for accessing the field via an interface.

type RestoreAssetRestoreAsset added in v0.9.0 

type RestoreAssetRestoreAsset struct {
	Id string `json:"id"`
	// The asset's URN, grammar v2 (cor:urn:010:01): hrn:asset:<root>:<mem...>:assets:<asset.id>,
	// emitted by emitAssetUrnV2 from the holding memory's STORED urn.
	//
	// <mem...> is one or more atoms, not always one. A per-user memory urn minted
	// before the #697 Stage-3 flip is still compound (<root>:<agent>:app-user:<id>
	// and friends), and each extra memory atom lengthens the asset URN with it —
	// so the 'assets' marker is not at a fixed offset. A parser recovering the
	// holding memory must take everything between the type word and that marker,
	// never a fixed two-atom prefix. Prefer locating the LAST 'assets' atom and
	// reading the id after it (assetIdFromRef does exactly this).
	//
	// Two degraded shapes a parser must tolerate, both of which really occur:
	// * hrn:asset:unknown:assets:<asset.id> — the holding memory row could not
	// be loaded. Carries no memory identity at all.
	// * <memory.urn>:assets:<asset.id> — the pre-#697 shape, with NO hrn:asset:
	// prefix, served when v2 emission throws (empty, over-length or
	// charset-invalid atom in the stored memory urn). It interpolates the
	// stored memory urn verbatim, which is normally bare (<root>:<slug>), so
	// this shape usually looks like acme.com:docs:assets:<id>.
	//
	// A third oddity is reachable through the NORMAL branch, not a fallback: a
	// legacy memories.urn row that predates the chk_memory_urn_not_prefixed
	// guardrail can still hold a rendered hrn:mem:-prefixed value, and that
	// composes into hrn:asset:hrn:mem:<root>:<slug>:assets:<id>. A prefix strip
	// that assumes one leading type word will mis-read it.
	Urn       string  `json:"urn"`
	Filename  string  `json:"filename"`
	DeletedAt *string `json:"deletedAt"`
}

RestoreAssetRestoreAsset includes the requested fields of the GraphQL type Asset.

func (*RestoreAssetRestoreAsset) GetDeletedAt added in v0.9.0 

func (v *RestoreAssetRestoreAsset) GetDeletedAt() *string

GetDeletedAt returns RestoreAssetRestoreAsset.DeletedAt, and is useful for accessing the field via an interface.

func (*RestoreAssetRestoreAsset) GetFilename added in v0.9.0 

func (v *RestoreAssetRestoreAsset) GetFilename() string

GetFilename returns RestoreAssetRestoreAsset.Filename, and is useful for accessing the field via an interface.

func (*RestoreAssetRestoreAsset) GetId added in v0.9.0 

func (v *RestoreAssetRestoreAsset) GetId() string

GetId returns RestoreAssetRestoreAsset.Id, and is useful for accessing the field via an interface.

func (*RestoreAssetRestoreAsset) GetUrn added in v0.9.0 

func (v *RestoreAssetRestoreAsset) GetUrn() string

GetUrn returns RestoreAssetRestoreAsset.Urn, and is useful for accessing the field via an interface.

type RestoreNodeRevisionResponse added in v0.7.0 

type RestoreNodeRevisionResponse struct {
	// Restore a node to a previous revision (#617).
	//
	// Default (truncate: false): snapshots the CURRENT node state into history
	// first, then restores the node's fields to the revision — non-destructive,
	// the restore itself becomes undoable.
	//
	// truncate: true: restores the node's fields to the revision AND deletes
	// every NodeRevision NEWER than the selected one (createdAt strictly greater),
	// WITHOUT creating a pre-restore snapshot. Boundary is EXCLUSIVE of the
	// selected row: the selected revision is KEPT and becomes the new baseline
	// (the most-recent snapshot afterward); its era and older survive. The live
	// revision counter still advances monotonically for the restore itself.
	// Restore + truncate run in one transaction (atomic).
	RestoreNodeRevision *RestoreNodeRevisionRestoreNodeRevisionNode `json:"restoreNodeRevision"`
}

RestoreNodeRevisionResponse is returned by RestoreNodeRevision on success.

func RestoreNodeRevision added in v0.7.0 

func RestoreNodeRevision(
	ctx_ context.Context,
	client_ graphql.Client,
	revisionId string,
	truncate *bool,
) (data_ *RestoreNodeRevisionResponse, err_ error)

Restore a snapshot. Default snapshots-then-restores (undoable). truncate:true also deletes every snapshot newer than the selected one, which becomes the new baseline (restore+truncate is one atomic transaction). omitempty so an unset flag falls through to the server default (false), never sending null.

func (*RestoreNodeRevisionResponse) GetRestoreNodeRevision added in v0.7.0 

func (v *RestoreNodeRevisionResponse) GetRestoreNodeRevision() *RestoreNodeRevisionRestoreNodeRevisionNode

GetRestoreNodeRevision returns RestoreNodeRevisionResponse.RestoreNodeRevision, and is useful for accessing the field via an interface.

type RestoreNodeRevisionRestoreNodeRevisionNode added in v0.7.0 

type RestoreNodeRevisionRestoreNodeRevisionNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType  string `json:"nodeType"`
	UpdatedAt string `json:"updatedAt"`
}

RestoreNodeRevisionRestoreNodeRevisionNode includes the requested fields of the GraphQL type Node.

func (*RestoreNodeRevisionRestoreNodeRevisionNode) GetId added in v0.7.0 

func (v *RestoreNodeRevisionRestoreNodeRevisionNode) GetId() string

GetId returns RestoreNodeRevisionRestoreNodeRevisionNode.Id, and is useful for accessing the field via an interface.

func (*RestoreNodeRevisionRestoreNodeRevisionNode) GetLoc added in v0.7.0 

func (v *RestoreNodeRevisionRestoreNodeRevisionNode) GetLoc() string

GetLoc returns RestoreNodeRevisionRestoreNodeRevisionNode.Loc, and is useful for accessing the field via an interface.

func (*RestoreNodeRevisionRestoreNodeRevisionNode) GetMemoryId added in v0.7.0 

func (v *RestoreNodeRevisionRestoreNodeRevisionNode) GetMemoryId() string

GetMemoryId returns RestoreNodeRevisionRestoreNodeRevisionNode.MemoryId, and is useful for accessing the field via an interface.

func (*RestoreNodeRevisionRestoreNodeRevisionNode) GetName added in v0.7.0 

func (v *RestoreNodeRevisionRestoreNodeRevisionNode) GetName() string

GetName returns RestoreNodeRevisionRestoreNodeRevisionNode.Name, and is useful for accessing the field via an interface.

func (*RestoreNodeRevisionRestoreNodeRevisionNode) GetNodeType added in v0.7.0 

func (v *RestoreNodeRevisionRestoreNodeRevisionNode) GetNodeType() string

GetNodeType returns RestoreNodeRevisionRestoreNodeRevisionNode.NodeType, and is useful for accessing the field via an interface.

func (*RestoreNodeRevisionRestoreNodeRevisionNode) GetUpdatedAt added in v0.7.0 

func (v *RestoreNodeRevisionRestoreNodeRevisionNode) GetUpdatedAt() string

GetUpdatedAt returns RestoreNodeRevisionRestoreNodeRevisionNode.UpdatedAt, and is useful for accessing the field via an interface.

type RetireWorkerResponse added in v0.9.0 

type RetireWorkerResponse struct {
	// #974 — retire a Worker (cor:agt:020:02): end the casting while reserving
	// its name FOREVER. A retired worker stops authoring team chat at once (the
	// worker-App pin checks retirement at post time), takes no new work records,
	// and refuses new session bindings; the row and its name reservation
	// survive. Idempotent — retiring an already-retired worker returns it
	// unchanged. Same authorization as castWorker. workerRef is the worker's id
	// or its URN (#991).
	RetireWorker *RetireWorkerRetireWorker `json:"retireWorker"`
}

RetireWorkerResponse is returned by RetireWorker on success.

func RetireWorker added in v0.9.0 

func RetireWorker(
	ctx_ context.Context,
	client_ graphql.Client,
	workerRef string,
) (data_ *RetireWorkerResponse, err_ error)

Idempotent; the name stays reserved forever (cor:agt:020:02 — PR trailers and chat archives reference it). The retired worker stops authoring and takes no new sessions.

func (*RetireWorkerResponse) GetRetireWorker added in v0.9.0 

func (v *RetireWorkerResponse) GetRetireWorker() *RetireWorkerRetireWorker

GetRetireWorker returns RetireWorkerResponse.RetireWorker, and is useful for accessing the field via an interface.

type RetireWorkerRetireWorker added in v0.9.0 

type RetireWorkerRetireWorker struct {
	WorkerFields `json:"-"`
}

RetireWorkerRetireWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*RetireWorkerRetireWorker) GetAgentId added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetAgentId() string

GetAgentId returns RetireWorkerRetireWorker.AgentId, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetAppId added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetAppId() string

GetAppId returns RetireWorkerRetireWorker.AppId, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetCreatedAt added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetCreatedAt() string

GetCreatedAt returns RetireWorkerRetireWorker.CreatedAt, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetCreatedBy added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetCreatedBy() *string

GetCreatedBy returns RetireWorkerRetireWorker.CreatedBy, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetHasLiveSession added in v0.13.0 

func (v *RetireWorkerRetireWorker) GetHasLiveSession() *bool

GetHasLiveSession returns RetireWorkerRetireWorker.HasLiveSession, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetHeldAt added in v0.10.0 

func (v *RetireWorkerRetireWorker) GetHeldAt() *string

GetHeldAt returns RetireWorkerRetireWorker.HeldAt, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetHeldByUserId added in v0.10.0 

func (v *RetireWorkerRetireWorker) GetHeldByUserId() *string

GetHeldByUserId returns RetireWorkerRetireWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetId added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetId() string

GetId returns RetireWorkerRetireWorker.Id, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetLastActiveAt added in v0.13.0 

func (v *RetireWorkerRetireWorker) GetLastActiveAt() *string

GetLastActiveAt returns RetireWorkerRetireWorker.LastActiveAt, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetMemoryId added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetMemoryId() *string

GetMemoryId returns RetireWorkerRetireWorker.MemoryId, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetName added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetName() string

GetName returns RetireWorkerRetireWorker.Name, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetPortalUrl added in v0.12.0 

func (v *RetireWorkerRetireWorker) GetPortalUrl() *string

GetPortalUrl returns RetireWorkerRetireWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetPrompt added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetPrompt() *string

GetPrompt returns RetireWorkerRetireWorker.Prompt, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetPromptOverride added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetPromptOverride() *string

GetPromptOverride returns RetireWorkerRetireWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetRepos added in v0.12.0 

func (v *RetireWorkerRetireWorker) GetRepos() []string

GetRepos returns RetireWorkerRetireWorker.Repos, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetRetiredAt added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetRetiredAt() *string

GetRetiredAt returns RetireWorkerRetireWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetRetiredBy added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetRetiredBy() *string

GetRetiredBy returns RetireWorkerRetireWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetRole added in v0.9.0 

func (v *RetireWorkerRetireWorker) GetRole() *string

GetRole returns RetireWorkerRetireWorker.Role, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetSlug added in v0.10.0 

func (v *RetireWorkerRetireWorker) GetSlug() string

GetSlug returns RetireWorkerRetireWorker.Slug, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) GetUrn added in v0.10.0 

func (v *RetireWorkerRetireWorker) GetUrn() *string

GetUrn returns RetireWorkerRetireWorker.Urn, and is useful for accessing the field via an interface.

func (*RetireWorkerRetireWorker) MarshalJSON added in v0.9.0 

func (v *RetireWorkerRetireWorker) MarshalJSON() ([]byte, error)

func (*RetireWorkerRetireWorker) UnmarshalJSON added in v0.9.0 

func (v *RetireWorkerRetireWorker) UnmarshalJSON(b []byte) error

type RevisionFields added in v0.7.0 

type RevisionFields struct {
	Id          string   `json:"id"`
	NodeId      string   `json:"nodeId"`
	Loc         string   `json:"loc"`
	Name        string   `json:"name"`
	Description *string  `json:"description"`
	Tags        []string `json:"tags"`
	CreatedAt   string   `json:"createdAt"`
	// The editing User id, when a user is known (#620). Use editedByUser for resolution.
	EditedBy *string `json:"editedBy"`
	// What is known about the editor when no User id is available (#620):
	// 'github:<login>' / 'email:<addr>' / 'user:<id>' identity strings, or
	// 'app:<App.id>' for App-key principals. (Legacy free-form #88 reasons /
	// commit messages that squatted in editedBy were migrated to revLabel.)
	EditedByInfo *string `json:"editedByInfo"`
	// The editor resolved to a user (handle + URN) — from editedBy as a User id,
	// the createdBy fallback (#619), or an identity-string form of editedByInfo
	// ('github:<login>' resolves via the user's linked GitHub username). Null when
	// nothing resolves — the portal falls back to the raw strings. Public
	// identifiers only (#617).
	EditedByUser *RevisionFieldsEditedByUserNodeRevisionEditor `json:"editedByUser"`
	// User-settable label for this revision (#620, 500-char cap) — set via updateNodeRevision; also captures the 'reason' supplied with the edit that took this snapshot (legacy reasons were migrated here).
	RevLabel *string `json:"revLabel"`
	// Which node fields the edit that took this snapshot changed, e.g.
	// ["abstract","tags"] (#620). The snapshot is the PRE-edit state, so this
	// describes the delta between this snapshot and the state that replaced it.
	// Empty for legacy rows.
	Changes []string `json:"changes"`
}

Shared projection for list / single-snapshot / label reads.

func (*RevisionFields) GetChanges added in v0.7.0 

func (v *RevisionFields) GetChanges() []string

GetChanges returns RevisionFields.Changes, and is useful for accessing the field via an interface.

func (*RevisionFields) GetCreatedAt added in v0.7.0 

func (v *RevisionFields) GetCreatedAt() string

GetCreatedAt returns RevisionFields.CreatedAt, and is useful for accessing the field via an interface.

func (*RevisionFields) GetDescription added in v0.7.0 

func (v *RevisionFields) GetDescription() *string

GetDescription returns RevisionFields.Description, and is useful for accessing the field via an interface.

func (*RevisionFields) GetEditedBy added in v0.7.0 

func (v *RevisionFields) GetEditedBy() *string

GetEditedBy returns RevisionFields.EditedBy, and is useful for accessing the field via an interface.

func (*RevisionFields) GetEditedByInfo added in v0.7.0 

func (v *RevisionFields) GetEditedByInfo() *string

GetEditedByInfo returns RevisionFields.EditedByInfo, and is useful for accessing the field via an interface.

func (*RevisionFields) GetEditedByUser added in v0.7.0 

func (v *RevisionFields) GetEditedByUser() *RevisionFieldsEditedByUserNodeRevisionEditor

GetEditedByUser returns RevisionFields.EditedByUser, and is useful for accessing the field via an interface.

func (*RevisionFields) GetId added in v0.7.0 

func (v *RevisionFields) GetId() string

GetId returns RevisionFields.Id, and is useful for accessing the field via an interface.

func (*RevisionFields) GetLoc added in v0.7.0 

func (v *RevisionFields) GetLoc() string

GetLoc returns RevisionFields.Loc, and is useful for accessing the field via an interface.

func (*RevisionFields) GetName added in v0.7.0 

func (v *RevisionFields) GetName() string

GetName returns RevisionFields.Name, and is useful for accessing the field via an interface.

func (*RevisionFields) GetNodeId added in v0.7.0 

func (v *RevisionFields) GetNodeId() string

GetNodeId returns RevisionFields.NodeId, and is useful for accessing the field via an interface.

func (*RevisionFields) GetRevLabel added in v0.7.0 

func (v *RevisionFields) GetRevLabel() *string

GetRevLabel returns RevisionFields.RevLabel, and is useful for accessing the field via an interface.

func (*RevisionFields) GetTags added in v0.7.0 

func (v *RevisionFields) GetTags() []string

GetTags returns RevisionFields.Tags, and is useful for accessing the field via an interface.

type RevisionFieldsEditedByUserNodeRevisionEditor added in v0.7.0 

type RevisionFieldsEditedByUserNodeRevisionEditor struct {
	Handle *string `json:"handle"`
	Urn    *string `json:"urn"`
}

RevisionFieldsEditedByUserNodeRevisionEditor includes the requested fields of the GraphQL type NodeRevisionEditor. The GraphQL type's documentation follows.

A revision's editor resolved to PUBLIC IDENTIFIERS ONLY (#617). Deliberately excludes name / email / any PII — resolving editedBy must never widen the disclosure surface. handle + urn are the same public identifiers the users search already exposes, so no per-caller visibility gate applies.

func (*RevisionFieldsEditedByUserNodeRevisionEditor) GetHandle added in v0.7.0 

func (v *RevisionFieldsEditedByUserNodeRevisionEditor) GetHandle() *string

GetHandle returns RevisionFieldsEditedByUserNodeRevisionEditor.Handle, and is useful for accessing the field via an interface.

func (*RevisionFieldsEditedByUserNodeRevisionEditor) GetUrn added in v0.7.0 

func (v *RevisionFieldsEditedByUserNodeRevisionEditor) GetUrn() *string

GetUrn returns RevisionFieldsEditedByUserNodeRevisionEditor.Urn, and is useful for accessing the field via an interface.

type RevokeConnectionGrantResponse added in v0.7.0 

type RevokeConnectionGrantResponse struct {
	// Revoke a connection grant you created (soft delete). Owner-only.
	RevokeConnectionGrant bool `json:"revokeConnectionGrant"`
}

RevokeConnectionGrantResponse is returned by RevokeConnectionGrant on success.

func RevokeConnectionGrant added in v0.7.0 

func RevokeConnectionGrant(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *RevokeConnectionGrantResponse, err_ error)

func (*RevokeConnectionGrantResponse) GetRevokeConnectionGrant added in v0.7.0 

func (v *RevokeConnectionGrantResponse) GetRevokeConnectionGrant() bool

GetRevokeConnectionGrant returns RevokeConnectionGrantResponse.RevokeConnectionGrant, and is useful for accessing the field via an interface.

type RevokePrincipalGrantResponse added in v0.7.0 

type RevokePrincipalGrantResponse struct {
	// Revoke an action grant (org-ADMIN, interactive-only; soft delete).
	RevokePrincipalGrant bool `json:"revokePrincipalGrant"`
}

RevokePrincipalGrantResponse is returned by RevokePrincipalGrant on success.

func RevokePrincipalGrant added in v0.7.0 

func RevokePrincipalGrant(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *RevokePrincipalGrantResponse, err_ error)

Revoke an action grant (org ADMIN; soft delete).

func (*RevokePrincipalGrantResponse) GetRevokePrincipalGrant added in v0.7.0 

func (v *RevokePrincipalGrantResponse) GetRevokePrincipalGrant() bool

GetRevokePrincipalGrant returns RevokePrincipalGrantResponse.RevokePrincipalGrant, and is useful for accessing the field via an interface.

type RevokeUserApiKeyResponse added in v0.3.0 

type RevokeUserApiKeyResponse struct {
	// 025-oauth-for-mcp FR-004: revoke a user-scoped API key owned by
	// the calling User. Returns the updated UserApiKey so the portal
	// can render the new revokedAt without a refetch (PR-137 review
	// delta D3 — was Boolean). Idempotent for already-revoked keys;
	// rejected with FORBIDDEN if the key belongs to another user;
	// NOT_FOUND if id does not exist; UNAUTHENTICATED for AppKey-
	// resolved callers.
	RevokeUserApiKey *RevokeUserApiKeyRevokeUserApiKey `json:"revokeUserApiKey"`
}

RevokeUserApiKeyResponse is returned by RevokeUserApiKey on success.

func RevokeUserApiKey added in v0.3.0 

func RevokeUserApiKey(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *RevokeUserApiKeyResponse, err_ error)

Idempotent for an already-revoked key; returns the updated key.

func (*RevokeUserApiKeyResponse) GetRevokeUserApiKey added in v0.3.0 

func (v *RevokeUserApiKeyResponse) GetRevokeUserApiKey() *RevokeUserApiKeyRevokeUserApiKey

GetRevokeUserApiKey returns RevokeUserApiKeyResponse.RevokeUserApiKey, and is useful for accessing the field via an interface.

type RevokeUserApiKeyRevokeUserApiKey added in v0.3.0 

type RevokeUserApiKeyRevokeUserApiKey struct {
	UserApiKeyFields `json:"-"`
}

RevokeUserApiKeyRevokeUserApiKey includes the requested fields of the GraphQL type UserApiKey. The GraphQL type's documentation follows.

025-oauth-for-mcp: user-scoped bearer-token credential. Mirrors the AppKey shape but resolves to a User instead of an App. Surfaced to the portal revocation UI (Phase 3) so users can audit + revoke their own keys. userId is intentionally absent — for self-service v1 the caller is always the owner; admin-tooling auditability is out of scope (see contracts/graphql-mutations.md, PR-137 delta D1).

func (*RevokeUserApiKeyRevokeUserApiKey) GetCreatedAt added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) GetCreatedAt() string

GetCreatedAt returns RevokeUserApiKeyRevokeUserApiKey.CreatedAt, and is useful for accessing the field via an interface.

func (*RevokeUserApiKeyRevokeUserApiKey) GetId added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) GetId() string

GetId returns RevokeUserApiKeyRevokeUserApiKey.Id, and is useful for accessing the field via an interface.

func (*RevokeUserApiKeyRevokeUserApiKey) GetIssuedVia added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) GetIssuedVia() *string

GetIssuedVia returns RevokeUserApiKeyRevokeUserApiKey.IssuedVia, and is useful for accessing the field via an interface.

func (*RevokeUserApiKeyRevokeUserApiKey) GetKeyPreview added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) GetKeyPreview() string

GetKeyPreview returns RevokeUserApiKeyRevokeUserApiKey.KeyPreview, and is useful for accessing the field via an interface.

func (*RevokeUserApiKeyRevokeUserApiKey) GetLabel added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) GetLabel() *string

GetLabel returns RevokeUserApiKeyRevokeUserApiKey.Label, and is useful for accessing the field via an interface.

func (*RevokeUserApiKeyRevokeUserApiKey) GetLastUsedAt added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) GetLastUsedAt() *string

GetLastUsedAt returns RevokeUserApiKeyRevokeUserApiKey.LastUsedAt, and is useful for accessing the field via an interface.

func (*RevokeUserApiKeyRevokeUserApiKey) GetRevokedAt added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) GetRevokedAt() *string

GetRevokedAt returns RevokeUserApiKeyRevokeUserApiKey.RevokedAt, and is useful for accessing the field via an interface.

func (*RevokeUserApiKeyRevokeUserApiKey) MarshalJSON added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) MarshalJSON() ([]byte, error)

func (*RevokeUserApiKeyRevokeUserApiKey) UnmarshalJSON added in v0.3.0 

func (v *RevokeUserApiKeyRevokeUserApiKey) UnmarshalJSON(b []byte) error

type Role 

type Role string
const (
	RoleAdmin       Role = "ADMIN"
	RoleContributor Role = "CONTRIBUTOR"
	RoleOwner       Role = "OWNER"
	RoleReader      Role = "READER"
)

type RotateAgentWebhookResponse added in v0.6.0 

type RotateAgentWebhookResponse struct {
	// New secret + token; the old URL dies immediately.
	RotateAgentWebhook *RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials `json:"rotateAgentWebhook"`
}

RotateAgentWebhookResponse is returned by RotateAgentWebhook on success.

func RotateAgentWebhook added in v0.6.0 

func RotateAgentWebhook(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
) (data_ *RotateAgentWebhookResponse, err_ error)

func (*RotateAgentWebhookResponse) GetRotateAgentWebhook added in v0.6.0 

func (v *RotateAgentWebhookResponse) GetRotateAgentWebhook() *RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials

GetRotateAgentWebhook returns RotateAgentWebhookResponse.RotateAgentWebhook, and is useful for accessing the field via an interface.

type RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials added in v0.6.0 

type RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials struct {
	AgentWebhookCredentialFields `json:"-"`
}

RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials includes the requested fields of the GraphQL type AgentWebhookCredentials. The GraphQL type's documentation follows.

Create/rotate result — path + platform token are shown ONCE.

func (*RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) GetPath added in v0.6.0 

func (v *RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) GetPath() string

GetPath returns RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials.Path, and is useful for accessing the field via an interface.

func (*RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) GetToken added in v0.6.0 

func (v *RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) GetToken() string

GetToken returns RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials.Token, and is useful for accessing the field via an interface.

func (*RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) GetWebhook added in v0.6.0 

func (v *RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) GetWebhook() *AgentWebhookCredentialFieldsWebhookAgentWebhook

GetWebhook returns RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials.Webhook, and is useful for accessing the field via an interface.

func (*RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) MarshalJSON added in v0.6.0 

func (v *RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) MarshalJSON() ([]byte, error)

func (*RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) UnmarshalJSON added in v0.6.0 

func (v *RotateAgentWebhookRotateAgentWebhookAgentWebhookCredentials) UnmarshalJSON(b []byte) error

type RunTaskResponse added in v0.4.0 

type RunTaskResponse struct {
	// Run a task — a runnable node (isRunnable=true) — identified by a single
	// nodeRef (a node PK or a fully-qualified node URN, hrn:node:<root>:<memory>:<loc>),
	// resolved by the shared resolveNodeRef (#542). A bare loc without a memory
	// is rejected — pass a full URN or an ID. For loose-name matching and
	// interactive task selection use the MCP hadron_run_task tool, which
	// resolves to a concrete nodeRef before calling this.
	// By default RENDERS the task: returns the assembled instructions (node content
	// with {{arg}} substitution and referenced nodes) for an LLM agent to execute.
	// Pass appRef (App PK or URN) to EXECUTE instead (#529): the server mints a
	// MANUAL app run for the resolved task under that App and returns the run id
	// (poll appRun(ref:) for status + output). runAsSelf attributes the run to
	// the caller. Without appRef, behavior is unchanged.
	// Spec cor:api:060.
	RunTask string `json:"runTask"`
}

RunTaskResponse is returned by RunTask on success.

func RunTask added in v0.4.0 

func RunTask(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
	args *json.RawMessage,
	appRef *string,
	runAsSelf *bool,
) (data_ *RunTaskResponse, err_ error)

nodeRef identifies the task node — a PK or fully-qualified node URN (spec 007 entity-ref migration, server #542; the CLI resolves the ref to a PK first).

Two modes (server #529): WITHOUT appRef, runTask renders and returns the compiled prompt string. WITH appRef (App PK/URN), it mints a MANUAL app run for the task under that App and returns the run id (poll via `run get`). runAsSelf runs on behalf of the caller. Unset appRef/runAsSelf must be omitted, not sent as null (a null appRef would otherwise look like an explicit choice).

func (*RunTaskResponse) GetRunTask added in v0.4.0 

func (v *RunTaskResponse) GetRunTask() string

GetRunTask returns RunTaskResponse.RunTask, and is useful for accessing the field via an interface.

type ScopeExplainResponse added in v0.14.0 

type ScopeExplainResponse struct {
	// Spec 049 Phase 2 — explain a scope for YOU. Pass scopeRef, or a bare name
	// plus appRef (a name is unique only per owner, so it resolves in an App's
	// context: App › Agent › organization, never unioned — two installed Agents
	// each owning the name is SCOPE_NAME_AMBIGUOUS and you choose by scopeRef).
	// Returns the readable memories in order, the dropped COUNT, the shadowed
	// scopes, and with `loc` which memory would win for that address.
	ScopeExplain *ScopeExplainScopeExplainScopeExplanation `json:"scopeExplain"`
}

ScopeExplainResponse is returned by ScopeExplain on success.

func ScopeExplain added in v0.14.0 

func ScopeExplain(
	ctx_ context.Context,
	client_ graphql.Client,
	scopeRef *string,
	name *string,
	appRef *string,
	loc *string,
) (data_ *ScopeExplainResponse, err_ error)

Explain a scope FOR THE CALLER, and the CLI's only name->id resolver.

Pass scopeRef, or a bare `name` plus `appRef` — a name is unique only per owner, so it resolves in an App's context (App > Agent > organization, never unioned). Two installed Agents owning the name is SCOPE_NAME_AMBIGUOUS, which the caller answers by passing scopeRef instead.

`loc` asks which memory would WIN for that address under this scope. `shadowed` is the lower-precedence scopes of the same name the caller may read — disclosure, so a user can see that their name matched more than one thing. `droppedCount` is the in-scope-but-unreadable count.

func (*ScopeExplainResponse) GetScopeExplain added in v0.14.0 

func (v *ScopeExplainResponse) GetScopeExplain() *ScopeExplainScopeExplainScopeExplanation

GetScopeExplain returns ScopeExplainResponse.ScopeExplain, and is useful for accessing the field via an interface.

type ScopeExplainScopeExplainScopeExplanation added in v0.14.0 

type ScopeExplainScopeExplainScopeExplanation struct {
	ResolvedVia  ScopeOwnerType                                            `json:"resolvedVia"`
	DroppedCount int                                                       `json:"droppedCount"`
	Scope        *ScopeExplainScopeExplainScopeExplanationScope            `json:"scope"`
	Memories     []*ScopeExplainScopeExplainScopeExplanationMemoriesMemory `json:"memories"`
	Winner       *ScopeExplainScopeExplainScopeExplanationWinnerMemory     `json:"winner"`
	// Lower-precedence scopes of the same name in that App's context (that you may read).
	Shadowed []*ScopeExplainScopeExplainScopeExplanationShadowedScope `json:"shadowed"`
}

ScopeExplainScopeExplainScopeExplanation includes the requested fields of the GraphQL type ScopeExplanation. The GraphQL type's documentation follows.

What a scope resolves to FOR YOU: which owner tier won when resolved by name, the scopes it shadowed, the readable memories in order, how many were dropped for access, and — when `loc` was asked — which memory would win for that address (the input the task-customization operation consumes).

func (*ScopeExplainScopeExplainScopeExplanation) GetDroppedCount added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanation) GetDroppedCount() int

GetDroppedCount returns ScopeExplainScopeExplainScopeExplanation.DroppedCount, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanation) GetMemories added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanation) GetMemories() []*ScopeExplainScopeExplainScopeExplanationMemoriesMemory

GetMemories returns ScopeExplainScopeExplainScopeExplanation.Memories, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanation) GetResolvedVia added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanation) GetResolvedVia() ScopeOwnerType

GetResolvedVia returns ScopeExplainScopeExplainScopeExplanation.ResolvedVia, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanation) GetScope added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanation) GetScope() *ScopeExplainScopeExplainScopeExplanationScope

GetScope returns ScopeExplainScopeExplainScopeExplanation.Scope, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanation) GetShadowed added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanation) GetShadowed() []*ScopeExplainScopeExplainScopeExplanationShadowedScope

GetShadowed returns ScopeExplainScopeExplainScopeExplanation.Shadowed, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanation) GetWinner added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanation) GetWinner() *ScopeExplainScopeExplainScopeExplanationWinnerMemory

GetWinner returns ScopeExplainScopeExplainScopeExplanation.Winner, and is useful for accessing the field via an interface.

type ScopeExplainScopeExplainScopeExplanationMemoriesMemory added in v0.14.0 

type ScopeExplainScopeExplainScopeExplanationMemoriesMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn  string `json:"urn"`
	Name string `json:"name"`
}

ScopeExplainScopeExplainScopeExplanationMemoriesMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*ScopeExplainScopeExplainScopeExplanationMemoriesMemory) GetId added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationMemoriesMemory) GetId() string

GetId returns ScopeExplainScopeExplainScopeExplanationMemoriesMemory.Id, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationMemoriesMemory) GetName added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationMemoriesMemory) GetName() string

GetName returns ScopeExplainScopeExplainScopeExplanationMemoriesMemory.Name, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationMemoriesMemory) GetUrn added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationMemoriesMemory) GetUrn() string

GetUrn returns ScopeExplainScopeExplainScopeExplanationMemoriesMemory.Urn, and is useful for accessing the field via an interface.

type ScopeExplainScopeExplainScopeExplanationScope added in v0.14.0 

type ScopeExplainScopeExplainScopeExplanationScope struct {
	ScopeFields `json:"-"`
}

ScopeExplainScopeExplainScopeExplanationScope includes the requested fields of the GraphQL type Scope. The GraphQL type's documentation follows.

A named search SCOPE: an ORDERED list of memories with exactly one owner (organization | Agent | App). Selects memories only — no saved filter, no retrieval parameters — and NEVER grants: `memories` is the stored list ∩ what YOU may read (D-2026-09-13-004), and `hiddenMemoryCount` says how many you cannot see, as a count only. Names are unique per owner; `global` and `app` are reserved (the ladder's own views). Collisions across owners in an App's context resolve App › Agent › organization, never unioned.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetCreatedAt added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetCreatedAt() string

GetCreatedAt returns ScopeExplainScopeExplainScopeExplanationScope.CreatedAt, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetDescription added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetDescription() *string

GetDescription returns ScopeExplainScopeExplainScopeExplanationScope.Description, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetHiddenMemoryCount added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetHiddenMemoryCount() int

GetHiddenMemoryCount returns ScopeExplainScopeExplainScopeExplanationScope.HiddenMemoryCount, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetId added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetId() string

GetId returns ScopeExplainScopeExplainScopeExplanationScope.Id, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetMemoryCount added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetMemoryCount() int

GetMemoryCount returns ScopeExplainScopeExplainScopeExplanationScope.MemoryCount, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetName added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetName() string

GetName returns ScopeExplainScopeExplainScopeExplanationScope.Name, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetOwnerId added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetOwnerId() string

GetOwnerId returns ScopeExplainScopeExplainScopeExplanationScope.OwnerId, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetOwnerType added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetOwnerType() ScopeOwnerType

GetOwnerType returns ScopeExplainScopeExplainScopeExplanationScope.OwnerType, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetOwnerUrn added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetOwnerUrn() *string

GetOwnerUrn returns ScopeExplainScopeExplainScopeExplanationScope.OwnerUrn, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) GetUpdatedAt added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) GetUpdatedAt() *string

GetUpdatedAt returns ScopeExplainScopeExplainScopeExplanationScope.UpdatedAt, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationScope) MarshalJSON added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) MarshalJSON() ([]byte, error)

func (*ScopeExplainScopeExplainScopeExplanationScope) UnmarshalJSON added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationScope) UnmarshalJSON(b []byte) error

type ScopeExplainScopeExplainScopeExplanationShadowedScope added in v0.14.0 

type ScopeExplainScopeExplainScopeExplanationShadowedScope struct {
	ScopeFields `json:"-"`
}

ScopeExplainScopeExplainScopeExplanationShadowedScope includes the requested fields of the GraphQL type Scope. The GraphQL type's documentation follows.

A named search SCOPE: an ORDERED list of memories with exactly one owner (organization | Agent | App). Selects memories only — no saved filter, no retrieval parameters — and NEVER grants: `memories` is the stored list ∩ what YOU may read (D-2026-09-13-004), and `hiddenMemoryCount` says how many you cannot see, as a count only. Names are unique per owner; `global` and `app` are reserved (the ladder's own views). Collisions across owners in an App's context resolve App › Agent › organization, never unioned.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetCreatedAt added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetCreatedAt() string

GetCreatedAt returns ScopeExplainScopeExplainScopeExplanationShadowedScope.CreatedAt, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetDescription added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetDescription() *string

GetDescription returns ScopeExplainScopeExplainScopeExplanationShadowedScope.Description, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetHiddenMemoryCount added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetHiddenMemoryCount() int

GetHiddenMemoryCount returns ScopeExplainScopeExplainScopeExplanationShadowedScope.HiddenMemoryCount, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetId added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetId() string

GetId returns ScopeExplainScopeExplainScopeExplanationShadowedScope.Id, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetMemoryCount added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetMemoryCount() int

GetMemoryCount returns ScopeExplainScopeExplainScopeExplanationShadowedScope.MemoryCount, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetName added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetName() string

GetName returns ScopeExplainScopeExplainScopeExplanationShadowedScope.Name, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetOwnerId added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetOwnerId() string

GetOwnerId returns ScopeExplainScopeExplainScopeExplanationShadowedScope.OwnerId, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetOwnerType added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetOwnerType() ScopeOwnerType

GetOwnerType returns ScopeExplainScopeExplainScopeExplanationShadowedScope.OwnerType, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetOwnerUrn added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetOwnerUrn() *string

GetOwnerUrn returns ScopeExplainScopeExplainScopeExplanationShadowedScope.OwnerUrn, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) GetUpdatedAt added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) GetUpdatedAt() *string

GetUpdatedAt returns ScopeExplainScopeExplainScopeExplanationShadowedScope.UpdatedAt, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) MarshalJSON added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) MarshalJSON() ([]byte, error)

func (*ScopeExplainScopeExplainScopeExplanationShadowedScope) UnmarshalJSON added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationShadowedScope) UnmarshalJSON(b []byte) error

type ScopeExplainScopeExplainScopeExplanationWinnerMemory added in v0.14.0 

type ScopeExplainScopeExplainScopeExplanationWinnerMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn  string `json:"urn"`
	Name string `json:"name"`
}

ScopeExplainScopeExplainScopeExplanationWinnerMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*ScopeExplainScopeExplainScopeExplanationWinnerMemory) GetId added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationWinnerMemory) GetId() string

GetId returns ScopeExplainScopeExplainScopeExplanationWinnerMemory.Id, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationWinnerMemory) GetName added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationWinnerMemory) GetName() string

GetName returns ScopeExplainScopeExplainScopeExplanationWinnerMemory.Name, and is useful for accessing the field via an interface.

func (*ScopeExplainScopeExplainScopeExplanationWinnerMemory) GetUrn added in v0.14.0 

func (v *ScopeExplainScopeExplainScopeExplanationWinnerMemory) GetUrn() string

GetUrn returns ScopeExplainScopeExplainScopeExplanationWinnerMemory.Urn, and is useful for accessing the field via an interface.

type ScopeFields added in v0.14.0 

type ScopeFields struct {
	Id          string         `json:"id"`
	Name        string         `json:"name"`
	Description *string        `json:"description"`
	OwnerType   ScopeOwnerType `json:"ownerType"`
	// ID of the owning organization / Agent / App.
	OwnerId string `json:"ownerId"`
	// Bare stored URN of the owner, when it has one.
	OwnerUrn *string `json:"ownerUrn"`
	// How many memories the scope lists in total.
	MemoryCount int `json:"memoryCount"`
	// How many of them you may NOT read (count only — never their names).
	HiddenMemoryCount int     `json:"hiddenMemoryCount"`
	CreatedAt         string  `json:"createdAt"`
	UpdatedAt         *string `json:"updatedAt"`
}

ScopeFields includes the GraphQL fields of Scope requested by the fragment ScopeFields. The GraphQL type's documentation follows.

A named search SCOPE: an ORDERED list of memories with exactly one owner (organization | Agent | App). Selects memories only — no saved filter, no retrieval parameters — and NEVER grants: `memories` is the stored list ∩ what YOU may read (D-2026-09-13-004), and `hiddenMemoryCount` says how many you cannot see, as a count only. Names are unique per owner; `global` and `app` are reserved (the ladder's own views). Collisions across owners in an App's context resolve App › Agent › organization, never unioned.

func (*ScopeFields) GetCreatedAt added in v0.14.0 

func (v *ScopeFields) GetCreatedAt() string

GetCreatedAt returns ScopeFields.CreatedAt, and is useful for accessing the field via an interface.

func (*ScopeFields) GetDescription added in v0.14.0 

func (v *ScopeFields) GetDescription() *string

GetDescription returns ScopeFields.Description, and is useful for accessing the field via an interface.

func (*ScopeFields) GetHiddenMemoryCount added in v0.14.0 

func (v *ScopeFields) GetHiddenMemoryCount() int

GetHiddenMemoryCount returns ScopeFields.HiddenMemoryCount, and is useful for accessing the field via an interface.

func (*ScopeFields) GetId added in v0.14.0 

func (v *ScopeFields) GetId() string

GetId returns ScopeFields.Id, and is useful for accessing the field via an interface.

func (*ScopeFields) GetMemoryCount added in v0.14.0 

func (v *ScopeFields) GetMemoryCount() int

GetMemoryCount returns ScopeFields.MemoryCount, and is useful for accessing the field via an interface.

func (*ScopeFields) GetName added in v0.14.0 

func (v *ScopeFields) GetName() string

GetName returns ScopeFields.Name, and is useful for accessing the field via an interface.

func (*ScopeFields) GetOwnerId added in v0.14.0 

func (v *ScopeFields) GetOwnerId() string

GetOwnerId returns ScopeFields.OwnerId, and is useful for accessing the field via an interface.

func (*ScopeFields) GetOwnerType added in v0.14.0 

func (v *ScopeFields) GetOwnerType() ScopeOwnerType

GetOwnerType returns ScopeFields.OwnerType, and is useful for accessing the field via an interface.

func (*ScopeFields) GetOwnerUrn added in v0.14.0 

func (v *ScopeFields) GetOwnerUrn() *string

GetOwnerUrn returns ScopeFields.OwnerUrn, and is useful for accessing the field via an interface.

func (*ScopeFields) GetUpdatedAt added in v0.14.0 

func (v *ScopeFields) GetUpdatedAt() *string

GetUpdatedAt returns ScopeFields.UpdatedAt, and is useful for accessing the field via an interface.

type ScopeFilter added in v0.14.0 

type ScopeFilter struct {
	// ID or URN of an App — the resolution context.
	AppRef *string `json:"appRef"`
	Name   *string `json:"name"`
	// ID or URN of the owner (with ownerType).
	OwnerRef  *string         `json:"ownerRef"`
	OwnerType *ScopeOwnerType `json:"ownerType"`
}

Filter for the uniform scopes() list. Clauses AND-combine and only narrow the caller's readable set. `ownerType` + `ownerRef` name one owner; `appRef` selects the App's whole CONTEXT (its own scopes, its installed Agents', its organization's) — what a bare name would resolve against there.

func (*ScopeFilter) GetAppRef added in v0.14.0 

func (v *ScopeFilter) GetAppRef() *string

GetAppRef returns ScopeFilter.AppRef, and is useful for accessing the field via an interface.

func (*ScopeFilter) GetName added in v0.14.0 

func (v *ScopeFilter) GetName() *string

GetName returns ScopeFilter.Name, and is useful for accessing the field via an interface.

func (*ScopeFilter) GetOwnerRef added in v0.14.0 

func (v *ScopeFilter) GetOwnerRef() *string

GetOwnerRef returns ScopeFilter.OwnerRef, and is useful for accessing the field via an interface.

func (*ScopeFilter) GetOwnerType added in v0.14.0 

func (v *ScopeFilter) GetOwnerType() *ScopeOwnerType

GetOwnerType returns ScopeFilter.OwnerType, and is useful for accessing the field via an interface.

type ScopeMemories added in v0.14.0 

type ScopeMemories struct {
	// The scope's memories YOU may read, in scope order.
	Memories []*ScopeMemoriesMemoriesScopeMemoryEntry `json:"memories"`
}

The readable memories, in scope order. `position` is 0-based and is the scope's order, not the server's default sort — preserve it when rendering.

func (*ScopeMemories) GetMemories added in v0.14.0 

func (v *ScopeMemories) GetMemories() []*ScopeMemoriesMemoriesScopeMemoryEntry

GetMemories returns ScopeMemories.Memories, and is useful for accessing the field via an interface.

type ScopeMemoriesMemoriesScopeMemoryEntry added in v0.14.0 

type ScopeMemoriesMemoriesScopeMemoryEntry struct {
	// 0-based order within the scope.
	Position int                                          `json:"position"`
	Memory   *ScopeMemoriesMemoriesScopeMemoryEntryMemory `json:"memory"`
}

ScopeMemoriesMemoriesScopeMemoryEntry includes the requested fields of the GraphQL type ScopeMemoryEntry.

func (*ScopeMemoriesMemoriesScopeMemoryEntry) GetMemory added in v0.14.0 

func (v *ScopeMemoriesMemoriesScopeMemoryEntry) GetMemory() *ScopeMemoriesMemoriesScopeMemoryEntryMemory

GetMemory returns ScopeMemoriesMemoriesScopeMemoryEntry.Memory, and is useful for accessing the field via an interface.

func (*ScopeMemoriesMemoriesScopeMemoryEntry) GetPosition added in v0.14.0 

func (v *ScopeMemoriesMemoriesScopeMemoryEntry) GetPosition() int

GetPosition returns ScopeMemoriesMemoriesScopeMemoryEntry.Position, and is useful for accessing the field via an interface.

type ScopeMemoriesMemoriesScopeMemoryEntryMemory added in v0.14.0 

type ScopeMemoriesMemoriesScopeMemoryEntryMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
}

ScopeMemoriesMemoriesScopeMemoryEntryMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetId added in v0.14.0 

func (v *ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetId() string

GetId returns ScopeMemoriesMemoriesScopeMemoryEntryMemory.Id, and is useful for accessing the field via an interface.

func (*ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetName added in v0.14.0 

func (v *ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetName() string

GetName returns ScopeMemoriesMemoriesScopeMemoryEntryMemory.Name, and is useful for accessing the field via an interface.

func (*ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetShortDescription added in v0.14.0 

func (v *ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetShortDescription() *string

GetShortDescription returns ScopeMemoriesMemoriesScopeMemoryEntryMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetUrn added in v0.14.0 

func (v *ScopeMemoriesMemoriesScopeMemoryEntryMemory) GetUrn() string

GetUrn returns ScopeMemoriesMemoriesScopeMemoryEntryMemory.Urn, and is useful for accessing the field via an interface.

type ScopeOwnerType added in v0.14.0 

type ScopeOwnerType string

Which entity owns a Scope. Exactly one per scope (DB-enforced, the AiServiceConfig pattern). 

const (
	ScopeOwnerTypeAgent        ScopeOwnerType = "AGENT"
	ScopeOwnerTypeApp          ScopeOwnerType = "APP"
	ScopeOwnerTypeOrganization ScopeOwnerType = "ORGANIZATION"
)

type ScopesResponse added in v0.14.0 

type ScopesResponse struct {
	// Spec 049 Phase 2 — paginated list of the scopes you may read, optionally
	// narrowed by owner, by an App's resolution context, by name, and by the
	// cor:api:100:01 orgId (member-gated, no admin bypass; non-member ⇒ empty
	// page). Name-ascending (id tiebreak); limit default 50 / cap 200; limit: 0
	// ⇒ count only.
	Scopes *ScopesScopesScopesPage `json:"scopes"`
}

ScopesResponse is returned by Scopes on success.

func Scopes added in v0.14.0 

func Scopes(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *ScopeFilter,
	limit *int,
	offset *int,
	orgId *string,
) (data_ *ScopesResponse, err_ error)

Scopes visible to the caller. ScopeFilter narrows by owner (ownerRef + ownerType), by name, or by appRef — the App resolution context.

func (*ScopesResponse) GetScopes added in v0.14.0 

func (v *ScopesResponse) GetScopes() *ScopesScopesScopesPage

GetScopes returns ScopesResponse.Scopes, and is useful for accessing the field via an interface.

type ScopesScopesScopesPage added in v0.14.0 

type ScopesScopesScopesPage struct {
	Total int                                 `json:"total"`
	Items []*ScopesScopesScopesPageItemsScope `json:"items"`
}

ScopesScopesScopesPage includes the requested fields of the GraphQL type ScopesPage.

func (*ScopesScopesScopesPage) GetItems added in v0.14.0 

func (v *ScopesScopesScopesPage) GetItems() []*ScopesScopesScopesPageItemsScope

GetItems returns ScopesScopesScopesPage.Items, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPage) GetTotal added in v0.14.0 

func (v *ScopesScopesScopesPage) GetTotal() int

GetTotal returns ScopesScopesScopesPage.Total, and is useful for accessing the field via an interface.

type ScopesScopesScopesPageItemsScope added in v0.14.0 

type ScopesScopesScopesPageItemsScope struct {
	ScopeFields `json:"-"`
}

ScopesScopesScopesPageItemsScope includes the requested fields of the GraphQL type Scope. The GraphQL type's documentation follows.

A named search SCOPE: an ORDERED list of memories with exactly one owner (organization | Agent | App). Selects memories only — no saved filter, no retrieval parameters — and NEVER grants: `memories` is the stored list ∩ what YOU may read (D-2026-09-13-004), and `hiddenMemoryCount` says how many you cannot see, as a count only. Names are unique per owner; `global` and `app` are reserved (the ladder's own views). Collisions across owners in an App's context resolve App › Agent › organization, never unioned.

func (*ScopesScopesScopesPageItemsScope) GetCreatedAt added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetCreatedAt() string

GetCreatedAt returns ScopesScopesScopesPageItemsScope.CreatedAt, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetDescription added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetDescription() *string

GetDescription returns ScopesScopesScopesPageItemsScope.Description, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetHiddenMemoryCount added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetHiddenMemoryCount() int

GetHiddenMemoryCount returns ScopesScopesScopesPageItemsScope.HiddenMemoryCount, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetId added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetId() string

GetId returns ScopesScopesScopesPageItemsScope.Id, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetMemoryCount added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetMemoryCount() int

GetMemoryCount returns ScopesScopesScopesPageItemsScope.MemoryCount, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetName added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetName() string

GetName returns ScopesScopesScopesPageItemsScope.Name, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetOwnerId added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetOwnerId() string

GetOwnerId returns ScopesScopesScopesPageItemsScope.OwnerId, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetOwnerType added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetOwnerType() ScopeOwnerType

GetOwnerType returns ScopesScopesScopesPageItemsScope.OwnerType, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetOwnerUrn added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetOwnerUrn() *string

GetOwnerUrn returns ScopesScopesScopesPageItemsScope.OwnerUrn, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) GetUpdatedAt added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) GetUpdatedAt() *string

GetUpdatedAt returns ScopesScopesScopesPageItemsScope.UpdatedAt, and is useful for accessing the field via an interface.

func (*ScopesScopesScopesPageItemsScope) MarshalJSON added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) MarshalJSON() ([]byte, error)

func (*ScopesScopesScopesPageItemsScope) UnmarshalJSON added in v0.14.0 

func (v *ScopesScopesScopesPageItemsScope) UnmarshalJSON(b []byte) error

type SearchNodesFindNodesFindNodesResult added in v0.6.0 

type SearchNodesFindNodesFindNodesResult struct {
	Total *int `json:"total"`
	// Reduced-fidelity flag(s); hits are usable. May carry MULTIPLE
	// comma-separated codes (e.g. 'no_vector_index,literal_fallback') —
	// parse the set, never compare the whole string. Codes: no_vector_index,
	// embedding_unavailable, literal_fallback, and_relaxed_to_or (a bare
	// multi-term keyword query matched nothing under AND, so it was retried as
	// OR and these hits match ANY term), scope_narrowed (spec 049: the scope
	// this search ran under lists memories you cannot read; they were dropped
	// and `scope.droppedCount` says how many).
	Degraded *string `json:"degraded"`
	Reason   *string `json:"reason"`
	// Spec 049 (D-2026-09-13-002): what this search was produced under. Null when no scope applied (the pre-049 accessible set, optionally org-narrowed).
	Scope *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo `json:"scope"`
	Hits  []*SearchNodesFindNodesFindNodesResultHitsNodeHit        `json:"hits"`
}

SearchNodesFindNodesFindNodesResult includes the requested fields of the GraphQL type FindNodesResult. The GraphQL type's documentation follows.

Envelope for findNodes (cor:api:090) — the unified node list + search field (it replaced the removed nodes + nodeSearch queries). hits carry per-hit score + vector metadata; passages carry chunk-granularity results; reason/degraded surface no-index / reduced-fidelity outcomes.

func (*SearchNodesFindNodesFindNodesResult) GetDegraded added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResult) GetDegraded() *string

GetDegraded returns SearchNodesFindNodesFindNodesResult.Degraded, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResult) GetHits added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResult) GetHits() []*SearchNodesFindNodesFindNodesResultHitsNodeHit

GetHits returns SearchNodesFindNodesFindNodesResult.Hits, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResult) GetReason added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResult) GetReason() *string

GetReason returns SearchNodesFindNodesFindNodesResult.Reason, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResult) GetScope added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResult) GetScope() *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo

GetScope returns SearchNodesFindNodesFindNodesResult.Scope, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResult) GetTotal added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResult) GetTotal() *int

GetTotal returns SearchNodesFindNodesFindNodesResult.Total, and is useful for accessing the field via an interface.

type SearchNodesFindNodesFindNodesResultHitsNodeHit added in v0.6.0 

type SearchNodesFindNodesFindNodesResultHitsNodeHit struct {
	Score  *float64                                                            `json:"score"`
	Vector *SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta `json:"vector"`
	Node   *SearchNodesFindNodesFindNodesResultHitsNodeHitNode                 `json:"node"`
}

SearchNodesFindNodesFindNodesResultHitsNodeHit includes the requested fields of the GraphQL type NodeHit. The GraphQL type's documentation follows.

A scored node hit (cor:api:090:04). score is null for an unscored filtered list (no query).

func (*SearchNodesFindNodesFindNodesResultHitsNodeHit) GetNode added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHit) GetNode() *SearchNodesFindNodesFindNodesResultHitsNodeHitNode

GetNode returns SearchNodesFindNodesFindNodesResultHitsNodeHit.Node, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHit) GetScore added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHit) GetScore() *float64

GetScore returns SearchNodesFindNodesFindNodesResultHitsNodeHit.Score, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHit) GetVector added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHit) GetVector() *SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta

GetVector returns SearchNodesFindNodesFindNodesResultHitsNodeHit.Vector, and is useful for accessing the field via an interface.

type SearchNodesFindNodesFindNodesResultHitsNodeHitNode added in v0.6.0 

type SearchNodesFindNodesFindNodesResultHitsNodeHitNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType    string   `json:"nodeType"`
	Tags        []string `json:"tags"`
	Description *string  `json:"description"`
	// Paragraph-length summary of this node. Opt-in on hadron_get_node via the contentScope parameter. hadron_find_nodes preview surfacing ships in spec 031 US2 — not yet live. Never surfaced in hadron_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"`
	UpdatedAt  string           `json:"updatedAt"`
	Properties *json.RawMessage `json:"properties"`
	Data       *json.RawMessage `json:"data"`
}

SearchNodesFindNodesFindNodesResultHitsNodeHitNode includes the requested fields of the GraphQL type Node.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetAbstract added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetAbstract() *string

GetAbstract returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Abstract, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetData added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetData() *json.RawMessage

GetData returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Data, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetDescription added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetDescription() *string

GetDescription returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Description, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetId added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetId() string

GetId returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Id, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetLoc added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetLoc() string

GetLoc returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Loc, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetMemoryId added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetMemoryId() string

GetMemoryId returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.MemoryId, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetName added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetName() string

GetName returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Name, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetNodeType added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetNodeType() string

GetNodeType returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.NodeType, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetProperties added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetProperties() *json.RawMessage

GetProperties returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Properties, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetTags added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetTags() []string

GetTags returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.Tags, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetUpdatedAt added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitNode) GetUpdatedAt() string

GetUpdatedAt returns SearchNodesFindNodesFindNodesResultHitsNodeHitNode.UpdatedAt, and is useful for accessing the field via an interface.

type SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta added in v0.6.0 

type SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta struct {
	AbstractStale *bool `json:"abstractStale"`
}

SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta includes the requested fields of the GraphQL type NodeVectorMeta. The GraphQL type's documentation follows.

Per-hit vector-retrieval lineage (cor:api:090:04), present when a hit came from the vector index.

func (*SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta) GetAbstractStale added in v0.6.0 

func (v *SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta) GetAbstractStale() *bool

GetAbstractStale returns SearchNodesFindNodesFindNodesResultHitsNodeHitVectorNodeVectorMeta.AbstractStale, and is useful for accessing the field via an interface.

type SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo added in v0.14.0 

type SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo struct {
	Kind         string   `json:"kind"`
	Label        string   `json:"label"`
	Source       string   `json:"source"`
	OwnerUrn     *string  `json:"ownerUrn"`
	MemoryUrns   []string `json:"memoryUrns"`
	DroppedCount int      `json:"droppedCount"`
}

SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo includes the requested fields of the GraphQL type SearchScopeInfo. The GraphQL type's documentation follows.

Spec 049 — the scope a search ran under (every result discloses it, D-2026-09-13-002). `kind`: scope | app | global | user-owned. `source`: call | session | active-app | active-org. `memoryUrns` lists only the memories YOU may read; `droppedCount` is how many the scope lists that you may not — a count, never their names.

func (*SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetDroppedCount added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetDroppedCount() int

GetDroppedCount returns SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo.DroppedCount, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetKind added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetKind() string

GetKind returns SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo.Kind, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetLabel added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetLabel() string

GetLabel returns SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo.Label, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetMemoryUrns added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetMemoryUrns() []string

GetMemoryUrns returns SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo.MemoryUrns, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetOwnerUrn added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetOwnerUrn() *string

GetOwnerUrn returns SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo.OwnerUrn, and is useful for accessing the field via an interface.

func (*SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetSource added in v0.14.0 

func (v *SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo) GetSource() string

GetSource returns SearchNodesFindNodesFindNodesResultScopeSearchScopeInfo.Source, and is useful for accessing the field via an interface.

type SearchNodesResponse added in v0.6.0 

type SearchNodesResponse struct {
	// Unified node search (cor:api:090) — the single node list + retrieval
	// surface (it replaced the removed `nodes` filter/list and `nodeSearch`
	// rank queries in PR3). Omit `query` for a filtered list in deterministic
	// order (subsumes `nodes`); pass `query` to rank by `mode`
	// (keyword | vector | hybrid | regex). Lexical modes honor boolean operators
	// (`(a OR b) AND c`, quoted phrases, NOT/-) — operator words are
	// UPPERCASE-ONLY, so natural phrases like 'not sure' search literally —
	// and `fields` as a ranking weight-mask. Malformed boolean syntax
	// (unmatched parenthesis, unterminated quote) DEGRADES to a literal phrase
	// search flagged `degraded: 'literal_fallback'` instead of erroring; only
	// mode: regex fails loudly on bad syntax. `filter` is the structured, AND-combined filter context
	// (SYSTEM memory class excluded by default; explicit wins). Returns a
	// scored-hit envelope. Access-scoped identically to the per-kind node queries.
	//
	// orgId (optional) narrows the accessible scope to a single organization the
	// caller is a member of; a non-member orgId returns an empty envelope
	// (total 0, no existence disclosure). Combined with filter.isRunnable: true
	// this is the canonical "the caller's runnable task nodes in one org" query
	// (there is no separate myTasks surface — a task is simply an isRunnable node).
	FindNodes *SearchNodesFindNodesFindNodesResult `json:"findNodes"`
}

SearchNodesResponse is returned by SearchNodes on success.

func SearchNodes added in v0.6.0 

func SearchNodes(
	ctx_ context.Context,
	client_ graphql.Client,
	query string,
	mode *FindNodesMode,
	filter *NodeFilter,
	sortProperty *gqltypes.NodePropertySort,
	limit *int,
	offset *int,
	scope *string,
	appRef *string,
	orgId *string,
	withProperties bool,
	withData bool,
) (data_ *SearchNodesResponse, err_ error)

Ranked node search backing `hadron search` (#135). Same unified findNodes field as nodes.graphql's FindNodes, but a search-shaped selection: per-hit score, abstract/description, and the vector abstract-staleness flag — so a result list is assessable at a glance without one `node get` per hit. Kept separate from FindNodes so the browse/list callers (`node ls`, exports, spec reads) don't pay for abstract payloads they never render.

The server treats an omitted NodeFilter field as "no constraint"; nil pointers must therefore be omitted, not sent as null — same contract as nodes.graphql. NodeWhereInput / NodePropertySort are bound to hand-authored structs (internal/api/gqltypes) — see nodes.graphql's FindNodes for why genqlient can't own the omitempty on the recursive NodeWhereInput.

func (*SearchNodesResponse) GetFindNodes added in v0.6.0 

func (v *SearchNodesResponse) GetFindNodes() *SearchNodesFindNodesFindNodesResult

GetFindNodes returns SearchNodesResponse.FindNodes, and is useful for accessing the field via an interface.

type SearchReplaceInNodesInput added in v0.3.1 

type SearchReplaceInNodesInput struct {
	CaseInsensitive *bool `json:"caseInsensitive"`
	// When true, report matches without writing anything.
	DryRun *bool `json:"dryRun"`
	// Which text fields to search. At least one required.
	Fields []NodeTextField `json:"fields"`
	// Memory IDs or URNs — selects every live node in each.
	MemoryIds []string `json:"memoryIds"`
	// Replacement. May be empty (deletes the matched text). Regex mode honors dollar-sign backrefs.
	NewText string `json:"newText"`
	// Explicit node IDs or fully-qualified URNs.
	NodeIds []string `json:"nodeIds"`
	// Text (literal) or RegExp source (regex mode) to find. Must be non-empty.
	OldText string `json:"oldText"`
	// Loc-prefix filter applied within 'memoryIds' (parent loc + descendants).
	Prefix *string `json:"prefix"`
	// Why this change was made — recorded on each changed node's revision-history
	// snapshot (NodeRevision.revLabel, #620; historically it squatted in
	// editedBy), mirroring hadron_update_node's reason arg.
	Reason *string `json:"reason"`
	// Treat oldText as a RegExp source and newText as a replacement pattern.
	Regex *bool `json:"regex"`
}

Bulk literal/regex search-and-replace across selected nodes.

Selection is a union — at least one of 'nodeIds' or 'memoryIds' is required: - nodeIds: explicit nodes (IDs or fully-qualified URNs). - memoryIds: every live node in those memories (IDs or URNs). - prefix: further restrict the memoryIds set to the node at 'prefix' plus its descendants, matched on colon loc-path boundaries (so 'auth' matches 'auth' and 'auth:tokens' but not 'authoring'). Requires 'memoryIds' — loc is only unique within a memory.

Matching is literal substring by default; set 'regex: true' to treat 'oldText' as a RegExp source (and 'newText' as a replacement pattern with dollar-sign backrefs). 'caseInsensitive' toggles case folding. Matching is always global.

Set 'dryRun: true' to get per-node/per-field match counts WITHOUT writing.

func (*SearchReplaceInNodesInput) GetCaseInsensitive added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetCaseInsensitive() *bool

GetCaseInsensitive returns SearchReplaceInNodesInput.CaseInsensitive, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetDryRun added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetDryRun() *bool

GetDryRun returns SearchReplaceInNodesInput.DryRun, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetFields added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetFields() []NodeTextField

GetFields returns SearchReplaceInNodesInput.Fields, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetMemoryIds added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetMemoryIds() []string

GetMemoryIds returns SearchReplaceInNodesInput.MemoryIds, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetNewText added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetNewText() string

GetNewText returns SearchReplaceInNodesInput.NewText, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetNodeIds added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetNodeIds() []string

GetNodeIds returns SearchReplaceInNodesInput.NodeIds, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetOldText added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetOldText() string

GetOldText returns SearchReplaceInNodesInput.OldText, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetPrefix added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetPrefix() *string

GetPrefix returns SearchReplaceInNodesInput.Prefix, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetReason added in v0.4.0 

func (v *SearchReplaceInNodesInput) GetReason() *string

GetReason returns SearchReplaceInNodesInput.Reason, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesInput) GetRegex added in v0.3.1 

func (v *SearchReplaceInNodesInput) GetRegex() *bool

GetRegex returns SearchReplaceInNodesInput.Regex, and is useful for accessing the field via an interface.

type SearchReplaceInNodesResponse added in v0.3.1 

type SearchReplaceInNodesResponse struct {
	// Bulk search-and-replace text across selected nodes (literal or regex).
	// Honors per-memory write auth, encryption, revision history, abstract
	// staleness, and re-embedding. Supports dryRun preview.
	SearchReplaceInNodes *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult `json:"searchReplaceInNodes"`
}

SearchReplaceInNodesResponse is returned by SearchReplaceInNodes on success.

func SearchReplaceInNodes added in v0.3.1 

func SearchReplaceInNodes(
	ctx_ context.Context,
	client_ graphql.Client,
	input *SearchReplaceInNodesInput,
) (data_ *SearchReplaceInNodesResponse, err_ error)

Bulk literal/regex search-and-replace across selected nodes (hadron-server#312). Unset optional selectors/flags serialize as null, which the server treats the same as absent (it checks `Array.isArray(nodeIds)` and null-vs-truthy on the flags), so no per-field omitempty is needed here.

func (*SearchReplaceInNodesResponse) GetSearchReplaceInNodes added in v0.3.1 

func (v *SearchReplaceInNodesResponse) GetSearchReplaceInNodes() *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult

GetSearchReplaceInNodes returns SearchReplaceInNodesResponse.SearchReplaceInNodes, and is useful for accessing the field via an interface.

type SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult added in v0.3.1 

type SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult struct {
	// Selected nodes whose requested text fields were actually inspected.
	NodesScanned int `json:"nodesScanned"`
	// Nodes with at least one replacement.
	NodesChanged      int `json:"nodesChanged"`
	TotalReplacements int `json:"totalReplacements"`
	// Echoes the request — true means nothing was written.
	DryRun bool `json:"dryRun"`
	// Per-node breakdown; only nodes with at least one match are listed.
	Results []*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult `json:"results"`
}

SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult includes the requested fields of the GraphQL type SearchReplaceResult.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetDryRun added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetDryRun() bool

GetDryRun returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult.DryRun, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetNodesChanged added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetNodesChanged() int

GetNodesChanged returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult.NodesChanged, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetNodesScanned added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetNodesScanned() int

GetNodesScanned returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult.NodesScanned, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetResults added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetResults() []*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult

GetResults returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult.Results, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetTotalReplacements added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult) GetTotalReplacements() int

GetTotalReplacements returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResult.TotalReplacements, and is useful for accessing the field via an interface.

type SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult added in v0.3.1 

type SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult struct {
	NodeId   string `json:"nodeId"`
	Loc      string `json:"loc"`
	MemoryId string `json:"memoryId"`
	// Total replacements across all searched fields on this node.
	Replacements int                                                                                                                        `json:"replacements"`
	Fields       []*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult `json:"fields"`
}

SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult includes the requested fields of the GraphQL type SearchReplaceNodeResult.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetFields added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetFields() []*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult

GetFields returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult.Fields, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetLoc added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetLoc() string

GetLoc returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult.Loc, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetMemoryId added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetMemoryId() string

GetMemoryId returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult.MemoryId, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetNodeId added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetNodeId() string

GetNodeId returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult.NodeId, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetReplacements added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetReplacements() int

GetReplacements returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResult.Replacements, and is useful for accessing the field via an interface.

type SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult added in v0.3.1 

type SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult struct {
	Field   NodeTextField `json:"field"`
	Matches int           `json:"matches"`
}

SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult includes the requested fields of the GraphQL type SearchReplaceFieldResult.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetField added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetField() NodeTextField

GetField returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult.Field, and is useful for accessing the field via an interface.

func (*SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetMatches added in v0.3.1 

func (v *SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetMatches() int

GetMatches returns SearchReplaceInNodesSearchReplaceInNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult.Matches, and is useful for accessing the field via an interface.

type SearchReplaceInSpecNodesResponse added in v0.18.0 

type SearchReplaceInSpecNodesResponse struct {
	// Governed bulk replacement inside one spec corpus, with exact preview binding. Every target must be unminted (#1591); SEARCH_REPLACE_NOT_DRAFT names minted ones.
	SearchReplaceInSpecNodes *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult `json:"searchReplaceInSpecNodes"`
}

SearchReplaceInSpecNodesResponse is returned by SearchReplaceInSpecNodes on success.

func SearchReplaceInSpecNodes added in v0.18.0 

func SearchReplaceInSpecNodes(
	ctx_ context.Context,
	client_ graphql.Client,
	input *SpecSearchReplaceInput,
) (data_ *SearchReplaceInSpecNodesResponse, err_ error)

#1294/#1459 — draft-only governed spec replacement. The server binds apply to the exact dry-run plan and reports protected selections explicitly.

func (*SearchReplaceInSpecNodesResponse) GetSearchReplaceInSpecNodes added in v0.18.0 

func (v *SearchReplaceInSpecNodesResponse) GetSearchReplaceInSpecNodes() *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult

GetSearchReplaceInSpecNodes returns SearchReplaceInSpecNodesResponse.SearchReplaceInSpecNodes, and is useful for accessing the field via an interface.

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult added in v0.18.0 

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult struct {
	// Unique authorized nodes selected before bulk-write protections are applied.
	NodesSelected int `json:"nodesSelected"`
	// Selected nodes whose requested text fields were actually inspected.
	NodesScanned int `json:"nodesScanned"`
	// Selected nodes protected from inspection and replacement.
	NodesSkipped int `json:"nodesSkipped"`
	// Nodes with at least one replacement.
	NodesChanged      int `json:"nodesChanged"`
	TotalReplacements int `json:"totalReplacements"`
	// Echoes the request — true means nothing was written.
	DryRun bool `json:"dryRun"`
	// Opaque exact preview fingerprint on the spec door; null on the generic door.
	Plan *string `json:"plan"`
	// Node-addressed protected selections on the spec door; null on the generic door.
	Skips []*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip `json:"skips"`
	// Per-node breakdown; only nodes with at least one match are listed.
	Results []*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult `json:"results"`
}

SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult includes the requested fields of the GraphQL type SearchReplaceResult.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetDryRun added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetDryRun() bool

GetDryRun returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.DryRun, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesChanged added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesChanged() int

GetNodesChanged returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.NodesChanged, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesScanned added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesScanned() int

GetNodesScanned returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.NodesScanned, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesSelected added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesSelected() int

GetNodesSelected returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.NodesSelected, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesSkipped added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetNodesSkipped() int

GetNodesSkipped returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.NodesSkipped, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetPlan added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetPlan() *string

GetPlan returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.Plan, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetResults added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetResults() []*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult

GetResults returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.Results, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetSkips added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetSkips() []*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip

GetSkips returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.Skips, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetTotalReplacements added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult) GetTotalReplacements() int

GetTotalReplacements returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResult.TotalReplacements, and is useful for accessing the field via an interface.

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult added in v0.18.0 

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult struct {
	NodeId   string `json:"nodeId"`
	Loc      string `json:"loc"`
	MemoryId string `json:"memoryId"`
	// Total replacements across all searched fields on this node.
	Replacements int                                                                                                                                `json:"replacements"`
	Fields       []*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult `json:"fields"`
}

SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult includes the requested fields of the GraphQL type SearchReplaceNodeResult.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetFields added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetFields() []*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult

GetFields returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult.Fields, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetLoc added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetLoc() string

GetLoc returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult.Loc, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetMemoryId added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetMemoryId() string

GetMemoryId returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult.MemoryId, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetNodeId added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetNodeId() string

GetNodeId returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult.NodeId, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetReplacements added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult) GetReplacements() int

GetReplacements returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResult.Replacements, and is useful for accessing the field via an interface.

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult added in v0.18.0 

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult struct {
	Field   NodeTextField `json:"field"`
	Matches int           `json:"matches"`
}

SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult includes the requested fields of the GraphQL type SearchReplaceFieldResult.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetField added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetField() NodeTextField

GetField returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult.Field, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetMatches added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult) GetMatches() int

GetMatches returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultResultsSearchReplaceNodeResultFieldsSearchReplaceFieldResult.Matches, and is useful for accessing the field via an interface.

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip added in v0.18.0 

type SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip struct {
	NodeId        string                  `json:"nodeId"`
	Loc           string                  `json:"loc"`
	Reason        SearchReplaceSkipReason `json:"reason"`
	GovernedKinds []string                `json:"governedKinds"`
}

SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip includes the requested fields of the GraphQL type SearchReplaceSkip.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetGovernedKinds added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetGovernedKinds() []string

GetGovernedKinds returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip.GovernedKinds, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetLoc added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetLoc() string

GetLoc returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip.Loc, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetNodeId added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetNodeId() string

GetNodeId returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip.NodeId, and is useful for accessing the field via an interface.

func (*SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetReason added in v0.18.0 

func (v *SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip) GetReason() SearchReplaceSkipReason

GetReason returns SearchReplaceInSpecNodesSearchReplaceInSpecNodesSearchReplaceResultSkipsSearchReplaceSkip.Reason, and is useful for accessing the field via an interface.

type SearchReplaceSkipReason added in v0.18.0 

type SearchReplaceSkipReason string
const (
	SearchReplaceSkipReasonOtherGovernedKind SearchReplaceSkipReason = "OTHER_GOVERNED_KIND"
	SearchReplaceSkipReasonProtectedAddress  SearchReplaceSkipReason = "PROTECTED_ADDRESS"
)

type SearchUsersResponse added in v0.3.0 

type SearchUsersResponse struct {
	// Uniform paginated user list (#473) — replaces the admin-only users list
	// and searchUsers. Platform ADMIN/OWNER: every live user, filter.query
	// optional. Everyone else: filter.query is REQUIRED (blank/omitted -> empty
	// page) and matching is enumeration-safe per cor:acl:070:02 — handle /
	// githubUsername by substring, email by exact match, name only where the
	// viewer may see it (self/admin/co-member). Name-ascending order (id
	// tiebreak); limit default 50 / cap 200; limit: 0 -> count only.
	Users *SearchUsersUsersUsersPage `json:"users"`
}

SearchUsersResponse is returned by SearchUsers on success.

func SearchUsers added in v0.3.0 

func SearchUsers(
	ctx_ context.Context,
	client_ graphql.Client,
	query *string,
	limit *int,
	offset *int,
) (data_ *SearchUsersResponse, err_ error)

Uniform paginated user list (hadron-server#473) — replaces searchUsers. Non-admin callers must pass filter.query (enumeration-safe matching: handle/githubUsername substring, email exact). Results are name-ascending, so an EXACT identifier match can sit past the first 200-cap page — user-ref resolution pages via api.CollectUntil with an exact-match short-circuit.

$query is nullable and omitempty: a nil pointer drops the variable, which GraphQL input-object coercion renders as `filter: {}` — i.e. an omitted query. That is the platform ADMIN/OWNER full-user-list path (a non-admin gets an empty page instead, per cor:acl:070:02), and it is the only way to enumerate accounts nobody thought to search for.

func (*SearchUsersResponse) GetUsers added in v0.5.1 

func (v *SearchUsersResponse) GetUsers() *SearchUsersUsersUsersPage

GetUsers returns SearchUsersResponse.Users, and is useful for accessing the field via an interface.

type SearchUsersUsersUsersPage added in v0.5.1 

type SearchUsersUsersUsersPage struct {
	Total int                                   `json:"total"`
	Items []*SearchUsersUsersUsersPageItemsUser `json:"items"`
}

SearchUsersUsersUsersPage includes the requested fields of the GraphQL type UsersPage.

func (*SearchUsersUsersUsersPage) GetItems added in v0.5.1 

func (v *SearchUsersUsersUsersPage) GetItems() []*SearchUsersUsersUsersPageItemsUser

GetItems returns SearchUsersUsersUsersPage.Items, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPage) GetTotal added in v0.5.1 

func (v *SearchUsersUsersUsersPage) GetTotal() int

GetTotal returns SearchUsersUsersUsersPage.Total, and is useful for accessing the field via an interface.

type SearchUsersUsersUsersPageItemsUser added in v0.5.1 

type SearchUsersUsersUsersPageItemsUser struct {
	UserFields `json:"-"`
}

SearchUsersUsersUsersPageItemsUser includes the requested fields of the GraphQL type User.

func (*SearchUsersUsersUsersPageItemsUser) GetEmail added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) GetEmail() *string

GetEmail returns SearchUsersUsersUsersPageItemsUser.Email, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetExternalAppId added in v0.9.0 

func (v *SearchUsersUsersUsersPageItemsUser) GetExternalAppId() *string

GetExternalAppId returns SearchUsersUsersUsersPageItemsUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetExternalId added in v0.9.0 

func (v *SearchUsersUsersUsersPageItemsUser) GetExternalId() *string

GetExternalId returns SearchUsersUsersUsersPageItemsUser.ExternalId, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetGithubId added in v0.9.0 

func (v *SearchUsersUsersUsersPageItemsUser) GetGithubId() *int

GetGithubId returns SearchUsersUsersUsersPageItemsUser.GithubId, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetGithubUsername added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) GetGithubUsername() *string

GetGithubUsername returns SearchUsersUsersUsersPageItemsUser.GithubUsername, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetHandle added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) GetHandle() *string

GetHandle returns SearchUsersUsersUsersPageItemsUser.Handle, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetId added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) GetId() string

GetId returns SearchUsersUsersUsersPageItemsUser.Id, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetIdentityProvider added in v0.9.0 

func (v *SearchUsersUsersUsersPageItemsUser) GetIdentityProvider() *string

GetIdentityProvider returns SearchUsersUsersUsersPageItemsUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetLinkedAt added in v0.9.0 

func (v *SearchUsersUsersUsersPageItemsUser) GetLinkedAt() *string

GetLinkedAt returns SearchUsersUsersUsersPageItemsUser.LinkedAt, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetName added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) GetName() *string

GetName returns SearchUsersUsersUsersPageItemsUser.Name, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetRoles added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) GetRoles() []Role

GetRoles returns SearchUsersUsersUsersPageItemsUser.Roles, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) GetUrn added in v0.14.0 

func (v *SearchUsersUsersUsersPageItemsUser) GetUrn() *string

GetUrn returns SearchUsersUsersUsersPageItemsUser.Urn, and is useful for accessing the field via an interface.

func (*SearchUsersUsersUsersPageItemsUser) MarshalJSON added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) MarshalJSON() ([]byte, error)

func (*SearchUsersUsersUsersPageItemsUser) UnmarshalJSON added in v0.5.1 

func (v *SearchUsersUsersUsersPageItemsUser) UnmarshalJSON(b []byte) error

type SecretFields added in v0.8.0 

type SecretFields struct {
	Id string `json:"id"`
	// Owner scope: user | org | app | memory.
	OwnerType string `json:"ownerType"`
	OwnerId   string `json:"ownerId"`
	// Cascade-resolution key; unique per owner; lowercase [a-z0-9-], max 64.
	Name string `json:"name"`
	// Extensible kind; v1: generic | webfetch-auth.
	Kind string `json:"kind"`
	// The NON-secret, inspectable half (webfetch-auth: { type, urlPrefix }).
	Metadata  *json.RawMessage `json:"metadata"`
	CreatedAt string           `json:"createdAt"`
	CreatedBy *string          `json:"createdBy"`
	UpdatedAt string           `json:"updatedAt"`
	UpdatedBy *string          `json:"updatedBy"`
}

SecretFields includes the GraphQL fields of Secret requested by the fragment SecretFields. The GraphQL type's documentation follows.

One named, owner-scoped secret — the general secret store (#677). Polymorphic owner (user | org | app | memory). The value is encrypted at rest and WRITE-ONLY: no field here ever returns it — kind + metadata are the inspectable half (you can see THAT a secret exists and, for webfetch-auth, WHERE it applies, without decrypting). A bare name resolves at run time via the CSS cascade, most-specific-first: memory -> app -> user -> org.

func (*SecretFields) GetCreatedAt added in v0.8.0 

func (v *SecretFields) GetCreatedAt() string

GetCreatedAt returns SecretFields.CreatedAt, and is useful for accessing the field via an interface.

func (*SecretFields) GetCreatedBy added in v0.8.0 

func (v *SecretFields) GetCreatedBy() *string

GetCreatedBy returns SecretFields.CreatedBy, and is useful for accessing the field via an interface.

func (*SecretFields) GetId added in v0.8.0 

func (v *SecretFields) GetId() string

GetId returns SecretFields.Id, and is useful for accessing the field via an interface.

func (*SecretFields) GetKind added in v0.8.0 

func (v *SecretFields) GetKind() string

GetKind returns SecretFields.Kind, and is useful for accessing the field via an interface.

func (*SecretFields) GetMetadata added in v0.8.0 

func (v *SecretFields) GetMetadata() *json.RawMessage

GetMetadata returns SecretFields.Metadata, and is useful for accessing the field via an interface.

func (*SecretFields) GetName added in v0.8.0 

func (v *SecretFields) GetName() string

GetName returns SecretFields.Name, and is useful for accessing the field via an interface.

func (*SecretFields) GetOwnerId added in v0.8.0 

func (v *SecretFields) GetOwnerId() string

GetOwnerId returns SecretFields.OwnerId, and is useful for accessing the field via an interface.

func (*SecretFields) GetOwnerType added in v0.8.0 

func (v *SecretFields) GetOwnerType() string

GetOwnerType returns SecretFields.OwnerType, and is useful for accessing the field via an interface.

func (*SecretFields) GetUpdatedAt added in v0.8.0 

func (v *SecretFields) GetUpdatedAt() string

GetUpdatedAt returns SecretFields.UpdatedAt, and is useful for accessing the field via an interface.

func (*SecretFields) GetUpdatedBy added in v0.8.0 

func (v *SecretFields) GetUpdatedBy() *string

GetUpdatedBy returns SecretFields.UpdatedBy, and is useful for accessing the field via an interface.

type SecretsResponse added in v0.8.0 

type SecretsResponse struct {
	// Paginated secret list for ONE owner scope (the hadron secret ls
	// surface). ownerRef accepts ID or URN (cor:api:140) and defaults to the
	// caller for ownerType user. An unresolvable ref or a non-entitled owner
	// yields an empty page — no disclosure. Name-ascending order (id
	// tiebreak); limit default 50 / cap 200; limit: 0 -> count only.
	Secrets *SecretsSecretsSecretsPage `json:"secrets"`
}

SecretsResponse is returned by Secrets on success.

func Secrets added in v0.8.0 

func Secrets(
	ctx_ context.Context,
	client_ graphql.Client,
	ownerType string,
	ownerRef *string,
	limit *int,
	offset *int,
) (data_ *SecretsResponse, err_ error)

func (*SecretsResponse) GetSecrets added in v0.8.0 

func (v *SecretsResponse) GetSecrets() *SecretsSecretsSecretsPage

GetSecrets returns SecretsResponse.Secrets, and is useful for accessing the field via an interface.

type SecretsSecretsSecretsPage added in v0.8.0 

type SecretsSecretsSecretsPage struct {
	Items []*SecretsSecretsSecretsPageItemsSecret `json:"items"`
	Total int                                     `json:"total"`
}

SecretsSecretsSecretsPage includes the requested fields of the GraphQL type SecretsPage. The GraphQL type's documentation follows.

Uniform paginated list shape (cor:api:120).

func (*SecretsSecretsSecretsPage) GetItems added in v0.8.0 

func (v *SecretsSecretsSecretsPage) GetItems() []*SecretsSecretsSecretsPageItemsSecret

GetItems returns SecretsSecretsSecretsPage.Items, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPage) GetTotal added in v0.8.0 

func (v *SecretsSecretsSecretsPage) GetTotal() int

GetTotal returns SecretsSecretsSecretsPage.Total, and is useful for accessing the field via an interface.

type SecretsSecretsSecretsPageItemsSecret added in v0.8.0 

type SecretsSecretsSecretsPageItemsSecret struct {
	SecretFields `json:"-"`
}

SecretsSecretsSecretsPageItemsSecret includes the requested fields of the GraphQL type Secret. The GraphQL type's documentation follows.

One named, owner-scoped secret — the general secret store (#677). Polymorphic owner (user | org | app | memory). The value is encrypted at rest and WRITE-ONLY: no field here ever returns it — kind + metadata are the inspectable half (you can see THAT a secret exists and, for webfetch-auth, WHERE it applies, without decrypting). A bare name resolves at run time via the CSS cascade, most-specific-first: memory -> app -> user -> org.

func (*SecretsSecretsSecretsPageItemsSecret) GetCreatedAt added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetCreatedAt() string

GetCreatedAt returns SecretsSecretsSecretsPageItemsSecret.CreatedAt, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetCreatedBy added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetCreatedBy() *string

GetCreatedBy returns SecretsSecretsSecretsPageItemsSecret.CreatedBy, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetId added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetId() string

GetId returns SecretsSecretsSecretsPageItemsSecret.Id, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetKind added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetKind() string

GetKind returns SecretsSecretsSecretsPageItemsSecret.Kind, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetMetadata added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetMetadata() *json.RawMessage

GetMetadata returns SecretsSecretsSecretsPageItemsSecret.Metadata, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetName added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetName() string

GetName returns SecretsSecretsSecretsPageItemsSecret.Name, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetOwnerId added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetOwnerId() string

GetOwnerId returns SecretsSecretsSecretsPageItemsSecret.OwnerId, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetOwnerType added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetOwnerType() string

GetOwnerType returns SecretsSecretsSecretsPageItemsSecret.OwnerType, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetUpdatedAt added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetUpdatedAt() string

GetUpdatedAt returns SecretsSecretsSecretsPageItemsSecret.UpdatedAt, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) GetUpdatedBy added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) GetUpdatedBy() *string

GetUpdatedBy returns SecretsSecretsSecretsPageItemsSecret.UpdatedBy, and is useful for accessing the field via an interface.

func (*SecretsSecretsSecretsPageItemsSecret) MarshalJSON added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) MarshalJSON() ([]byte, error)

func (*SecretsSecretsSecretsPageItemsSecret) UnmarshalJSON added in v0.8.0 

func (v *SecretsSecretsSecretsPageItemsSecret) UnmarshalJSON(b []byte) error

type SelectedSkillFilePlanInput added in v0.18.0 

type SelectedSkillFilePlanInput struct {
	Files []*SkillFileFactsInput `json:"files,omitempty"`
	Force *bool                  `json:"force,omitempty"`
	Host  *string                `json:"host,omitempty"`
	// Nonempty node IDs or fully qualified node URNs. Relative locs are refused.
	Nodes []string `json:"nodes"`
}

Plan installed individual skill files for explicit task refs; plugin exports use skillPlan.

func (*SelectedSkillFilePlanInput) GetFiles added in v0.18.0 

func (v *SelectedSkillFilePlanInput) GetFiles() []*SkillFileFactsInput

GetFiles returns SelectedSkillFilePlanInput.Files, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanInput) GetForce added in v0.18.0 

func (v *SelectedSkillFilePlanInput) GetForce() *bool

GetForce returns SelectedSkillFilePlanInput.Force, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanInput) GetHost added in v0.18.0 

func (v *SelectedSkillFilePlanInput) GetHost() *string

GetHost returns SelectedSkillFilePlanInput.Host, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanInput) GetNodes added in v0.18.0 

func (v *SelectedSkillFilePlanInput) GetNodes() []string

GetNodes returns SelectedSkillFilePlanInput.Nodes, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanResponse added in v0.18.0 

type SelectedSkillFilePlanResponse struct {
	// Selected individual skill files only. Plugin bundles cannot use node selectors.
	SelectedSkillFilePlan *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan `json:"selectedSkillFilePlan"`
}

SelectedSkillFilePlanResponse is returned by SelectedSkillFilePlan on success.

func SelectedSkillFilePlan added in v0.18.0 

func SelectedSkillFilePlan(
	ctx_ context.Context,
	client_ graphql.Client,
	input *SelectedSkillFilePlanInput,
) (data_ *SelectedSkillFilePlanResponse, err_ error)

Individual-file export uses its own server query. The dedicated input has no memory scope, and the returned scope marker prevents accidental orphan work. Optional fields are omitted when unset, never serialized as null. The file-facts input is shared with skillPlan. Genqlient may generate its Go type from either operation first, so both declare its omission contract.

func (*SelectedSkillFilePlanResponse) GetSelectedSkillFilePlan added in v0.18.0 

func (v *SelectedSkillFilePlanResponse) GetSelectedSkillFilePlan() *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan

GetSelectedSkillFilePlan returns SelectedSkillFilePlanResponse.SelectedSkillFilePlan, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan struct {
	// How many nodes carrying ANY declaration key were in scope. A plan over an
	// empty corpus and a plan the caller cannot see are otherwise the same empty
	// list, and a client that cannot tell them apart reports nothing-to-do for a
	// corpus it was denied.
	Scanned int `json:"scanned"`
	// How many of those were judged for THIS host — the number of entries. A node
	// declaring only another host is scanned and not judged, so the two differ by
	// design; the gap is a fact about the corpus, not a discrepancy.
	Judged int `json:"judged"`
	// True for scoped or selected exports: out-of-selection files are not classified as orphans.
	OrphanAssessmentSkipped bool `json:"orphanAssessmentSkipped"`
	// Opaque unavailable refs and selected nodes with no declaration for this host.
	SelectionResults []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult `json:"selectionResults"`
	Entries          []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry                `json:"entries"`
	Orphans          []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan                   `json:"orphans"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan includes the requested fields of the GraphQL type SkillPlan.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetEntries added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetEntries() []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry

GetEntries returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan.Entries, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetJudged added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetJudged() int

GetJudged returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan.Judged, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetOrphanAssessmentSkipped added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetOrphanAssessmentSkipped() bool

GetOrphanAssessmentSkipped returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan.OrphanAssessmentSkipped, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetOrphans added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetOrphans() []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan

GetOrphans returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan.Orphans, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetScanned added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetScanned() int

GetScanned returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan.Scanned, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetSelectionResults added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan) GetSelectionResults() []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult

GetSelectionResults returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlan.SelectionResults, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry struct {
	Urn    string `json:"urn"`
	NodeId string `json:"nodeId"`
	// The stored skill name (D12 retired derivation).
	Name string `json:"name"`
	// One of: current, stale, locally-edited, renamed, never-exported, orphaned,
	// unhashed, collision, unavailable, disabled. Null when the file could not be
	// parsed — a parse failure is reported as a FAILURE, not as a class.
	Class *string `json:"class"`
	// True when the file exists and does not parse. Reported identically by status and export.
	ParseFailure bool `json:"parseFailure"`
	// Why an enabled source is out of export in STATUS or EXPORT, or null when this category does not apply. Separate from the planned filesystem action.
	OutOfExportReason *string `json:"outOfExportReason"`
	// Source directory selected for a MOVE or REMOVE action; also reported for the renamed class.
	MovedFrom *string `json:"movedFrom"`
	// Present only for EXPORT, only for a class whose action writes, and only
	// when the node has no error findings — so a client cannot write a file the
	// server already judged broken.
	RenderedBody *string `json:"renderedBody"`
	// Present only for EXPORT. This is a planned action and its server-owned
	// reasons, not evidence that the client completed a filesystem write.
	ExportPlan *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry `json:"exportPlan"`
	Findings   []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding         `json:"findings"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry includes the requested fields of the GraphQL type SkillPlanEntry.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetClass added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetClass() *string

GetClass returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.Class, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetExportPlan added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetExportPlan() *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry

GetExportPlan returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.ExportPlan, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetFindings added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetFindings() []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding

GetFindings returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.Findings, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetMovedFrom added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetMovedFrom() *string

GetMovedFrom returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.MovedFrom, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetName added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetName() string

GetName returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.Name, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetNodeId added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetNodeId() string

GetNodeId returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.NodeId, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetOutOfExportReason added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetOutOfExportReason() *string

GetOutOfExportReason returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.OutOfExportReason, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetParseFailure added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetParseFailure() bool

GetParseFailure returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.ParseFailure, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetRenderedBody added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetRenderedBody() *string

GetRenderedBody returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.RenderedBody, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetUrn added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry) GetUrn() string

GetUrn returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntry.Urn, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry struct {
	Action SkillExportAction `json:"action"`
	// True when the client must leave any installed file unchanged.
	PreservesExistingFile bool                                                                                                                              `json:"preservesExistingFile"`
	Reasons               []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason `json:"reasons"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry includes the requested fields of the GraphQL type SkillExportPlanEntry. The GraphQL type's documentation follows.

The server's filesystem plan for one skill. The client still performs and reports actual local I/O; this object records only what the server judged safe.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetAction added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetAction() SkillExportAction

GetAction returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry.Action, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetPreservesExistingFile added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetPreservesExistingFile() bool

GetPreservesExistingFile returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry.PreservesExistingFile, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetReasons added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetReasons() []*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason

GetReasons returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry.Reasons, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason struct {
	// Stable machine-readable reason, usually a drift class or lint rule.
	Code string `json:"code"`
	// Actionable text clients can display without recreating server policy.
	Message string `json:"message"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason includes the requested fields of the GraphQL type SkillExportReason. The GraphQL type's documentation follows.

One server-owned reason for an export action.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetCode added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetCode() string

GetCode returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason.Code, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetMessage added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetMessage() string

GetMessage returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason.Message, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding struct {
	Rule string `json:"rule"`
	// Either error or warning — the same vocabulary spec lint renders.
	Severity string `json:"severity"`
	Message  string `json:"message"`
	Urn      string `json:"urn"`
	Memory   string `json:"memory"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding includes the requested fields of the GraphQL type SkillFinding. The GraphQL type's documentation follows.

One lint result, carrying the node and memory so a renderer never looks them back up.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMemory added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMemory() string

GetMemory returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Memory, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMessage added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMessage() string

GetMessage returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Message, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetRule added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetRule() string

GetRule returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Rule, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetSeverity added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetSeverity() string

GetSeverity returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Severity, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetUrn added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetUrn() string

GetUrn returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Urn, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan struct {
	DirName   string  `json:"dirName"`
	NodeId    *string `json:"nodeId"`
	SourceUrn *string `json:"sourceUrn"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan includes the requested fields of the GraphQL type SkillOrphan. The GraphQL type's documentation follows.

A file that paired with no declared node. Never removed without an explicit prune.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan) GetDirName added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan) GetDirName() string

GetDirName returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan.DirName, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan) GetNodeId added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan) GetNodeId() *string

GetNodeId returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan.NodeId, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan) GetSourceUrn added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan) GetSourceUrn() *string

GetSourceUrn returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanOrphansSkillOrphan.SourceUrn, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult struct {
	Ref    string                                                                                                          `json:"ref"`
	NodeId *string                                                                                                         `json:"nodeId"`
	Action SkillExportAction                                                                                               `json:"action"`
	Reason *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason `json:"reason"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult includes the requested fields of the GraphQL type SkillSelectionResult. The GraphQL type's documentation follows.

A named task that cannot produce a host entry. An unavailable ref reveals no node metadata.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetAction added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetAction() SkillExportAction

GetAction returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult.Action, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetNodeId added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetNodeId() *string

GetNodeId returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult.NodeId, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetReason added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetReason() *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason

GetReason returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult.Reason, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetRef added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult) GetRef() string

GetRef returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResult.Ref, and is useful for accessing the field via an interface.

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason added in v0.18.0 

type SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason struct {
	// Stable machine-readable reason, usually a drift class or lint rule.
	Code string `json:"code"`
	// Actionable text clients can display without recreating server policy.
	Message string `json:"message"`
}

SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason includes the requested fields of the GraphQL type SkillExportReason. The GraphQL type's documentation follows.

One server-owned reason for an export action.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason) GetCode added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason) GetCode() string

GetCode returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason.Code, and is useful for accessing the field via an interface.

func (*SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason) GetMessage added in v0.18.0 

func (v *SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason) GetMessage() string

GetMessage returns SelectedSkillFilePlanSelectedSkillFilePlanSkillPlanSelectionResultsSkillSelectionResultReasonSkillExportReason.Message, and is useful for accessing the field via an interface.

type ServerInfoResponse added in v0.9.0 

type ServerInfoResponse struct {
	// Identity of the hadron-server this GraphQL endpoint is bound to: the
	// server-identity version and the deployment's canonical base URL. The
	// GraphQL counterpart to the hadron_server_info MCP tool — both read the
	// same getDeploymentInfo() helper, so MCP and GraphQL callers get one
	// consistent answer to "which server/API am I talking to?".
	//
	// 'version' is HADRON_SERVER_VERSION — the MCP/API-surface contract
	// version, bumped when the tool/query surface changes in a caller-visible
	// way. It is intentionally NOT the repo's package.json release version.
	//
	// Public — no authentication required. Does NOT expose the DATABASE_URL
	// (it may carry credentials).
	ServerInfo *ServerInfoServerInfo `json:"serverInfo"`
}

ServerInfoResponse is returned by ServerInfo on success.

func ServerInfo added in v0.9.0 

func ServerInfo(
	ctx_ context.Context,
	client_ graphql.Client,
) (data_ *ServerInfoResponse, err_ error)

Identity of the running hadron-server (#102, MCP parity with hadron_server_info). Backs `hadron server-info`.

PUBLIC — the server answers this without authentication, which is what makes it a reachability probe as well as a version check. It deliberately does NOT expose DATABASE_URL (that may carry credentials).

`version` is HADRON_SERVER_VERSION: the MCP/API-surface CONTRACT version, bumped when the tool/query surface changes in a caller-visible way. It is NOT the server's package.json release version, so don't compare it against a release tag.

func (*ServerInfoResponse) GetServerInfo added in v0.9.0 

func (v *ServerInfoResponse) GetServerInfo() *ServerInfoServerInfo

GetServerInfo returns ServerInfoResponse.ServerInfo, and is useful for accessing the field via an interface.

type ServerInfoServerInfo added in v0.9.0 

type ServerInfoServerInfo struct {
	// HADRON_SERVER_VERSION — the MCP/API-surface contract version.
	Version string `json:"version"`
	// The deployment's canonical base URL (BASE_URL, else the local default).
	BaseUrl string `json:"baseUrl"`
}

ServerInfoServerInfo includes the requested fields of the GraphQL type ServerInfo. The GraphQL type's documentation follows.

Identity of the running hadron-server (see Query.serverInfo).

func (*ServerInfoServerInfo) GetBaseUrl added in v0.9.0 

func (v *ServerInfoServerInfo) GetBaseUrl() string

GetBaseUrl returns ServerInfoServerInfo.BaseUrl, and is useful for accessing the field via an interface.

func (*ServerInfoServerInfo) GetVersion added in v0.9.0 

func (v *ServerInfoServerInfo) GetVersion() string

GetVersion returns ServerInfoServerInfo.Version, and is useful for accessing the field via an interface.

type SessionInput added in v0.9.0 

type SessionInput struct {
	// #928 / cor:api:140: the role-Agent driving this session, as a PK or URN.
	// Resolves to Session.agentId. The caller must be able to READ the agent
	// (PUBLIC, or owner / org member) - a session is never attributed to an
	// agent the caller cannot see. Usually omitted with workerRef, which derives
	// it from the casting.
	AgentRef *string `json:"agentRef,omitempty"`
	// #943 / cor:api:140: the App this session is a unit of work for, as a PK or
	// URN. Resolves to Session.appId - the pivot that was previously stamped ONLY
	// from an App-key credential, which made a user-started session structurally
	// unable to satisfy the team-chat authorship gate (cor:agt:020:04 condition b,
	// SESSION_NOT_IN_APP). The caller must be a member of that App: an AppMember
	// at any role, an org member with CONTRIBUTOR+ on its owning org, or the
	// owner of a user-owned App. Unknown or deleted App: BAD_USER_INPUT;
	// non-member: FORBIDDEN. An App-key credential wins - if the caller
	// authenticated as an App and appRef names a DIFFERENT App, the call is
	// refused (SESSION_APP_MISMATCH).
	//
	// Uninstalled Apps differ by ref form, because App URNs are only unique
	// among ACTIVE rows (spec 021 FR-027: one live App plus N uninstalled
	// history rows may share a URN). By URN an uninstalled App is simply not
	// found - BAD_USER_INPUT - since there is no single row the URN names; by
	// PK it is found and refused APP_UNINSTALLED.
	AppRef     *string `json:"appRef,omitempty"`
	Branch     *string `json:"branch,omitempty"`
	CustomerId *string `json:"customerId,omitempty"`
	// #940: take over a worker whose binding would otherwise refuse WORKER_TAKEN.
	// Only meaningful with workerRef. Clients must surface the WORKER_TAKEN
	// payload (who last drove it, when) before retrying with force - that IS the
	// informed-takeover contract; force exists so the override is explicit,
	// never the default.
	Force           *bool   `json:"force,omitempty"`
	Host            *string `json:"host,omitempty"`
	Id              string  `json:"id"`
	Language        *string `json:"language,omitempty"`
	LlmModel        *string `json:"llmModel,omitempty"`
	ParentSessionId *string `json:"parentSessionId,omitempty"`
	// The session's stated intent (Session.plan) - what this session is about. MCP's hadron_start_session description lands here.
	Plan          *string `json:"plan,omitempty"`
	PrNumber      *int    `json:"prNumber,omitempty"`
	PrevSessionId *string `json:"prevSessionId,omitempty"`
	Repo          *string `json:"repo,omitempty"`
	Tool          *string `json:"tool,omitempty"`
	// #928 coding-session provenance.
	TranscriptPath *string `json:"transcriptPath,omitempty"`
	Type           *string `json:"type,omitempty"`
	// #974 / cor:agt:020:03: the Worker (named casting) this session works as.
	// Three forms resolve, told apart by SHAPE (never by trying each in turn, so
	// a typo'd URN can't silently fall through to a roster search):
	//
	// - the worker's NAME ("Iris") — #990. Unique per App, case-insensitively,
	// matched with the DATABASE's lower(), the expression
	// workers_app_name_uniq indexes. Requires App context (appRef, an App-key
	// credential, or an MCP active-App selection): a name means nothing without
	// one, so a nameless-App call refuses SESSION_WORKER_NAME_NEEDS_APP rather
	// than guessing across the caller's Apps. Gated on the STAFF READ GATE
	// before the lookup runs — resolving a name discloses roster membership,
	// which the id/URN forms never do.
	//
	// Which refusal you get depends on WHERE the denial happens, and clients
	// should not assume one code covers both: a caller who supplied appRef has
	// already been checked against the same participant predicate, so an
	// outsider is refused FORBIDDEN there, before any name is read. Only a
	// denial at the in-branch staff gate — reachable when the App came from an
	// App-key credential rather than appRef — is masked as WORKER_NOT_FOUND,
	// indistinguishable from an App with no such worker.
	// - the worker's URN (hrn:worker:<root>:<app-slug>:<slug>, #991); the URN's
	// leaf is the derived slug, never the display name (cor:agt:020:02).
	// - the worker's id.
	//
	// Resolves to Session.workerId, and stamps Session.agentId with the worker's
	// role-agent. The worker must belong to the session's App: with appRef (or an
	// App-key credential) it must match the worker's App; without one, the
	// worker's App becomes the session's, behind the same membership gate as
	// appRef. A retired worker refuses (WORKER_RETIRED). #940: a worker with an
	// ACTIVE session refuses WORKER_TAKEN — extensions carry workerId, sessionId,
	// lastDriver, lastSeenAt, everything the takeover prompt needs — unless
	// force is true (informed takeover, cor:agt:020:03: show who last drove it,
	// proceed only on explicit override, never silently).
	WorkerRef *string `json:"workerRef,omitempty"`
}

func (*SessionInput) GetAgentRef added in v0.9.0 

func (v *SessionInput) GetAgentRef() *string

GetAgentRef returns SessionInput.AgentRef, and is useful for accessing the field via an interface.

func (*SessionInput) GetAppRef added in v0.9.0 

func (v *SessionInput) GetAppRef() *string

GetAppRef returns SessionInput.AppRef, and is useful for accessing the field via an interface.

func (*SessionInput) GetBranch added in v0.9.0 

func (v *SessionInput) GetBranch() *string

GetBranch returns SessionInput.Branch, and is useful for accessing the field via an interface.

func (*SessionInput) GetCustomerId added in v0.9.0 

func (v *SessionInput) GetCustomerId() *string

GetCustomerId returns SessionInput.CustomerId, and is useful for accessing the field via an interface.

func (*SessionInput) GetForce added in v0.9.0 

func (v *SessionInput) GetForce() *bool

GetForce returns SessionInput.Force, and is useful for accessing the field via an interface.

func (*SessionInput) GetHost added in v0.9.0 

func (v *SessionInput) GetHost() *string

GetHost returns SessionInput.Host, and is useful for accessing the field via an interface.

func (*SessionInput) GetId added in v0.9.0 

func (v *SessionInput) GetId() string

GetId returns SessionInput.Id, and is useful for accessing the field via an interface.

func (*SessionInput) GetLanguage added in v0.9.0 

func (v *SessionInput) GetLanguage() *string

GetLanguage returns SessionInput.Language, and is useful for accessing the field via an interface.

func (*SessionInput) GetLlmModel added in v0.9.0 

func (v *SessionInput) GetLlmModel() *string

GetLlmModel returns SessionInput.LlmModel, and is useful for accessing the field via an interface.

func (*SessionInput) GetParentSessionId added in v0.9.0 

func (v *SessionInput) GetParentSessionId() *string

GetParentSessionId returns SessionInput.ParentSessionId, and is useful for accessing the field via an interface.

func (*SessionInput) GetPlan added in v0.9.0 

func (v *SessionInput) GetPlan() *string

GetPlan returns SessionInput.Plan, and is useful for accessing the field via an interface.

func (*SessionInput) GetPrNumber added in v0.9.0 

func (v *SessionInput) GetPrNumber() *int

GetPrNumber returns SessionInput.PrNumber, and is useful for accessing the field via an interface.

func (*SessionInput) GetPrevSessionId added in v0.9.0 

func (v *SessionInput) GetPrevSessionId() *string

GetPrevSessionId returns SessionInput.PrevSessionId, and is useful for accessing the field via an interface.

func (*SessionInput) GetRepo added in v0.9.0 

func (v *SessionInput) GetRepo() *string

GetRepo returns SessionInput.Repo, and is useful for accessing the field via an interface.

func (*SessionInput) GetTool added in v0.9.0 

func (v *SessionInput) GetTool() *string

GetTool returns SessionInput.Tool, and is useful for accessing the field via an interface.

func (*SessionInput) GetTranscriptPath added in v0.9.0 

func (v *SessionInput) GetTranscriptPath() *string

GetTranscriptPath returns SessionInput.TranscriptPath, and is useful for accessing the field via an interface.

func (*SessionInput) GetType added in v0.9.0 

func (v *SessionInput) GetType() *string

GetType returns SessionInput.Type, and is useful for accessing the field via an interface.

func (*SessionInput) GetWorkerRef added in v0.9.0 

func (v *SessionInput) GetWorkerRef() *string

GetWorkerRef returns SessionInput.WorkerRef, and is useful for accessing the field via an interface.

type SkillExportAction added in v0.16.0 

type SkillExportAction string

A client-side filesystem action planned by the server. It does not claim that I/O occurred. 

const (
	SkillExportActionFail   SkillExportAction = "FAIL"
	SkillExportActionMove   SkillExportAction = "MOVE"
	SkillExportActionRefuse SkillExportAction = "REFUSE"
	SkillExportActionRemove SkillExportAction = "REMOVE"
	SkillExportActionSkip   SkillExportAction = "SKIP"
	SkillExportActionWrite  SkillExportAction = "WRITE"
)

type SkillExportPlanResponse added in v0.16.0 

type SkillExportPlanResponse struct {
	// #1177 section 3 — the SKILL SEAM: the server judges, the client does I/O.
	//
	// One surface serving skill lint, skill status and skill export. The client
	// sends what it can see of each file on disk; the server returns a drift
	// CLASS and the lint findings per declared node, plus the rendered body for
	// anything the client is to write.
	//
	// A QUERY, not a mutation, and that is the contract. Nothing here writes to a
	// node — publishing is one-way, and the only writer in the feature is the
	// client's own filesystem. So status and lint cannot write by construction
	// rather than by promise.
	//
	// The client cannot name a drift class: the vocabulary is the server's, so it
	// cannot drift between clients. A node failing lint is never given a rendered
	// body, so a client cannot write a file the server judged broken.
	SkillPlan *SkillExportPlanSkillPlan `json:"skillPlan"`
}

SkillExportPlanResponse is returned by SkillExportPlan on success.

func SkillExportPlan added in v0.16.0 

func SkillExportPlan(
	ctx_ context.Context,
	client_ graphql.Client,
	input *SkillPlanInput,
) (data_ *SkillExportPlanResponse, err_ error)

SkillExportPlan is `skill export`'s own operation (#621): the one that selects `renderedBody` and the server's per-entry `exportPlan`. It is a separate operation, not extra fields on SkillPlan, so `status` and `lint` still CANNOT receive a body (TestSkillPlanQueryNeverSelectsRenderedBody).

The server decides every ACTION (WRITE/MOVE/REMOVE/SKIP/REFUSE/FAIL) and its reasons, and renders the whole file. This client performs the I/O, reports what it actually did, and never invents a class or an action. `exportPlan` is a plan, not evidence: the report says what happened on disk.

The omitempty directives above bind to the shared SkillPlanInput / SkillFileFactsInput types, so they apply here too. `force` in particular is omitted unless --force was given.

func (*SkillExportPlanResponse) GetSkillPlan added in v0.16.0 

func (v *SkillExportPlanResponse) GetSkillPlan() *SkillExportPlanSkillPlan

GetSkillPlan returns SkillExportPlanResponse.SkillPlan, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlan added in v0.16.0 

type SkillExportPlanSkillPlan struct {
	// How many nodes carrying ANY declaration key were in scope. A plan over an
	// empty corpus and a plan the caller cannot see are otherwise the same empty
	// list, and a client that cannot tell them apart reports nothing-to-do for a
	// corpus it was denied.
	Scanned int `json:"scanned"`
	// How many of those were judged for THIS host — the number of entries. A node
	// declaring only another host is scanned and not judged, so the two differ by
	// design; the gap is a fact about the corpus, not a discrepancy.
	Judged int `json:"judged"`
	// Non-null only when EXPORT selected a persisted Scope.
	ScopeSelection *SkillExportPlanSkillPlanScopeSelection          `json:"scopeSelection"`
	Entries        []*SkillExportPlanSkillPlanEntriesSkillPlanEntry `json:"entries"`
	Orphans        []*SkillExportPlanSkillPlanOrphansSkillOrphan    `json:"orphans"`
	// Nodes in scope carrying a key under properties.exports that names no host
	// (#1292, cor:agt:030:06): an unrecognised key is reported, never read as an
	// alias, and never blocks anything. HOST-INDEPENDENT: the list is identical
	// in every host's plan, because the key belongs to none of them, so a client
	// reports each node once rather than once per host. A node here may also
	// have an entry, when it declares a known host too; one declaring only
	// unknown keys has none, and is part of the scanned-minus-judged gap.
	Unrecognized []*SkillExportPlanSkillPlanUnrecognized `json:"unrecognized"`
}

SkillExportPlanSkillPlan includes the requested fields of the GraphQL type SkillPlan.

func (*SkillExportPlanSkillPlan) GetEntries added in v0.16.0 

func (v *SkillExportPlanSkillPlan) GetEntries() []*SkillExportPlanSkillPlanEntriesSkillPlanEntry

GetEntries returns SkillExportPlanSkillPlan.Entries, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlan) GetJudged added in v0.16.0 

func (v *SkillExportPlanSkillPlan) GetJudged() int

GetJudged returns SkillExportPlanSkillPlan.Judged, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlan) GetOrphans added in v0.16.0 

func (v *SkillExportPlanSkillPlan) GetOrphans() []*SkillExportPlanSkillPlanOrphansSkillOrphan

GetOrphans returns SkillExportPlanSkillPlan.Orphans, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlan) GetScanned added in v0.16.0 

func (v *SkillExportPlanSkillPlan) GetScanned() int

GetScanned returns SkillExportPlanSkillPlan.Scanned, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlan) GetScopeSelection added in v0.18.0 

func (v *SkillExportPlanSkillPlan) GetScopeSelection() *SkillExportPlanSkillPlanScopeSelection

GetScopeSelection returns SkillExportPlanSkillPlan.ScopeSelection, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlan) GetUnrecognized added in v0.16.0 

func (v *SkillExportPlanSkillPlan) GetUnrecognized() []*SkillExportPlanSkillPlanUnrecognized

GetUnrecognized returns SkillExportPlanSkillPlan.Unrecognized, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanEntriesSkillPlanEntry added in v0.16.0 

type SkillExportPlanSkillPlanEntriesSkillPlanEntry struct {
	Urn    string `json:"urn"`
	NodeId string `json:"nodeId"`
	// The stored skill name (D12 retired derivation).
	Name string `json:"name"`
	// One of: current, stale, locally-edited, renamed, never-exported, orphaned,
	// unhashed, collision, unavailable, disabled. Null when the file could not be
	// parsed — a parse failure is reported as a FAILURE, not as a class.
	Class *string `json:"class"`
	// True when the file exists and does not parse. Reported identically by status and export.
	ParseFailure bool `json:"parseFailure"`
	// Why an enabled source is out of export in STATUS or EXPORT, or null when this category does not apply. Separate from the planned filesystem action.
	OutOfExportReason *string `json:"outOfExportReason"`
	// Source directory selected for a MOVE or REMOVE action; also reported for the renamed class.
	MovedFrom *string `json:"movedFrom"`
	// Present only for EXPORT, only for a class whose action writes, and only
	// when the node has no error findings — so a client cannot write a file the
	// server already judged broken.
	RenderedBody *string `json:"renderedBody"`
	// Present only for EXPORT. This is a planned action and its server-owned
	// reasons, not evidence that the client completed a filesystem write.
	ExportPlan *SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry `json:"exportPlan"`
	Findings   []*SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding         `json:"findings"`
}

SkillExportPlanSkillPlanEntriesSkillPlanEntry includes the requested fields of the GraphQL type SkillPlanEntry.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetClass added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetClass() *string

GetClass returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.Class, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetExportPlan added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetExportPlan() *SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry

GetExportPlan returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.ExportPlan, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetFindings added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetFindings() []*SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding

GetFindings returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.Findings, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetMovedFrom added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetMovedFrom() *string

GetMovedFrom returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.MovedFrom, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetName added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetName() string

GetName returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.Name, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetNodeId added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetNodeId() string

GetNodeId returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.NodeId, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetOutOfExportReason added in v0.18.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetOutOfExportReason() *string

GetOutOfExportReason returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.OutOfExportReason, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetParseFailure added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetParseFailure() bool

GetParseFailure returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.ParseFailure, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetRenderedBody added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetRenderedBody() *string

GetRenderedBody returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.RenderedBody, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetUrn added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntry) GetUrn() string

GetUrn returns SkillExportPlanSkillPlanEntriesSkillPlanEntry.Urn, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry added in v0.16.0 

type SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry struct {
	Action SkillExportAction `json:"action"`
	// True when the client must leave any installed file unchanged.
	PreservesExistingFile bool                                                                                                   `json:"preservesExistingFile"`
	Reasons               []*SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason `json:"reasons"`
}

SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry includes the requested fields of the GraphQL type SkillExportPlanEntry. The GraphQL type's documentation follows.

The server's filesystem plan for one skill. The client still performs and reports actual local I/O; this object records only what the server judged safe.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetAction added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetAction() SkillExportAction

GetAction returns SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry.Action, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetPreservesExistingFile added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetPreservesExistingFile() bool

GetPreservesExistingFile returns SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry.PreservesExistingFile, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetReasons added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry) GetReasons() []*SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason

GetReasons returns SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntry.Reasons, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason added in v0.16.0 

type SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason struct {
	// Stable machine-readable reason, usually a drift class or lint rule.
	Code string `json:"code"`
	// Actionable text clients can display without recreating server policy.
	Message string `json:"message"`
}

SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason includes the requested fields of the GraphQL type SkillExportReason. The GraphQL type's documentation follows.

One server-owned reason for an export action.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetCode added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetCode() string

GetCode returns SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason.Code, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetMessage added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason) GetMessage() string

GetMessage returns SkillExportPlanSkillPlanEntriesSkillPlanEntryExportPlanSkillExportPlanEntryReasonsSkillExportReason.Message, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding added in v0.16.0 

type SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding struct {
	Rule string `json:"rule"`
	// Either error or warning — the same vocabulary spec lint renders.
	Severity string `json:"severity"`
	Message  string `json:"message"`
	Urn      string `json:"urn"`
	Memory   string `json:"memory"`
}

SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding includes the requested fields of the GraphQL type SkillFinding. The GraphQL type's documentation follows.

One lint result, carrying the node and memory so a renderer never looks them back up.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMemory added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMemory() string

GetMemory returns SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Memory, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMessage added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMessage() string

GetMessage returns SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Message, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetRule added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetRule() string

GetRule returns SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Rule, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetSeverity added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetSeverity() string

GetSeverity returns SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Severity, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetUrn added in v0.16.0 

func (v *SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetUrn() string

GetUrn returns SkillExportPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Urn, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanOrphansSkillOrphan added in v0.16.0 

type SkillExportPlanSkillPlanOrphansSkillOrphan struct {
	DirName   string  `json:"dirName"`
	NodeId    *string `json:"nodeId"`
	SourceUrn *string `json:"sourceUrn"`
}

SkillExportPlanSkillPlanOrphansSkillOrphan includes the requested fields of the GraphQL type SkillOrphan. The GraphQL type's documentation follows.

A file that paired with no declared node. Never removed without an explicit prune.

func (*SkillExportPlanSkillPlanOrphansSkillOrphan) GetDirName added in v0.16.0 

func (v *SkillExportPlanSkillPlanOrphansSkillOrphan) GetDirName() string

GetDirName returns SkillExportPlanSkillPlanOrphansSkillOrphan.DirName, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanOrphansSkillOrphan) GetNodeId added in v0.16.0 

func (v *SkillExportPlanSkillPlanOrphansSkillOrphan) GetNodeId() *string

GetNodeId returns SkillExportPlanSkillPlanOrphansSkillOrphan.NodeId, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanOrphansSkillOrphan) GetSourceUrn added in v0.16.0 

func (v *SkillExportPlanSkillPlanOrphansSkillOrphan) GetSourceUrn() *string

GetSourceUrn returns SkillExportPlanSkillPlanOrphansSkillOrphan.SourceUrn, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanScopeSelection added in v0.18.0 

type SkillExportPlanSkillPlanScopeSelection struct {
	Id                  string `json:"id"`
	Name                string `json:"name"`
	ReadableMemoryCount int    `json:"readableMemoryCount"`
	DroppedCount        int    `json:"droppedCount"`
	// Stable digest for comparing separate host plans from one export.
	Fingerprint string `json:"fingerprint"`
}

SkillExportPlanSkillPlanScopeSelection includes the requested fields of the GraphQL type SkillPlanScopeSelection. The GraphQL type's documentation follows.

The live, access-intersected Scope selection used by this EXPORT plan.

func (*SkillExportPlanSkillPlanScopeSelection) GetDroppedCount added in v0.18.0 

func (v *SkillExportPlanSkillPlanScopeSelection) GetDroppedCount() int

GetDroppedCount returns SkillExportPlanSkillPlanScopeSelection.DroppedCount, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanScopeSelection) GetFingerprint added in v0.18.0 

func (v *SkillExportPlanSkillPlanScopeSelection) GetFingerprint() string

GetFingerprint returns SkillExportPlanSkillPlanScopeSelection.Fingerprint, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanScopeSelection) GetId added in v0.18.0 

func (v *SkillExportPlanSkillPlanScopeSelection) GetId() string

GetId returns SkillExportPlanSkillPlanScopeSelection.Id, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanScopeSelection) GetName added in v0.18.0 

func (v *SkillExportPlanSkillPlanScopeSelection) GetName() string

GetName returns SkillExportPlanSkillPlanScopeSelection.Name, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanScopeSelection) GetReadableMemoryCount added in v0.18.0 

func (v *SkillExportPlanSkillPlanScopeSelection) GetReadableMemoryCount() int

GetReadableMemoryCount returns SkillExportPlanSkillPlanScopeSelection.ReadableMemoryCount, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanUnrecognized added in v0.16.0 

type SkillExportPlanSkillPlanUnrecognized struct {
	Urn    string `json:"urn"`
	NodeId string `json:"nodeId"`
	// The node's display name, not a skill name: an unrecognised key has no host, so it declares no skill name anyone reads.
	Name   string `json:"name"`
	Memory string `json:"memory"`
	// How many unrecognised keys the node carries — the true total, whether or not each is listed.
	KeyCount int `json:"keyCount"`
	// The unrecognised keys LISTED, in UTF-8 byte order — e.g. codex for
	// properties.exports.codex. At most 10, and none over 128 bytes: the report
	// is bounded because properties is writer-controlled. keyCount is the total;
	// anything not listed is counted in one extra warning, never dropped silently.
	Keys []string `json:"keys"`
	// One warning per listed key, plus one for any not listed. Attributed to no host; never blocks.
	Findings []*SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding `json:"findings"`
}

SkillExportPlanSkillPlanUnrecognized includes the requested fields of the GraphQL type SkillPlanUnrecognized. The GraphQL type's documentation follows.

A node carrying one or more exports keys that name no host (#1292).

func (*SkillExportPlanSkillPlanUnrecognized) GetFindings added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognized) GetFindings() []*SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding

GetFindings returns SkillExportPlanSkillPlanUnrecognized.Findings, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognized) GetKeyCount added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognized) GetKeyCount() int

GetKeyCount returns SkillExportPlanSkillPlanUnrecognized.KeyCount, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognized) GetKeys added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognized) GetKeys() []string

GetKeys returns SkillExportPlanSkillPlanUnrecognized.Keys, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognized) GetMemory added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognized) GetMemory() string

GetMemory returns SkillExportPlanSkillPlanUnrecognized.Memory, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognized) GetName added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognized) GetName() string

GetName returns SkillExportPlanSkillPlanUnrecognized.Name, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognized) GetNodeId added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognized) GetNodeId() string

GetNodeId returns SkillExportPlanSkillPlanUnrecognized.NodeId, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognized) GetUrn added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognized) GetUrn() string

GetUrn returns SkillExportPlanSkillPlanUnrecognized.Urn, and is useful for accessing the field via an interface.

type SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding added in v0.16.0 

type SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding struct {
	Rule string `json:"rule"`
	// Either error or warning — the same vocabulary spec lint renders.
	Severity string `json:"severity"`
	Message  string `json:"message"`
	Urn      string `json:"urn"`
	Memory   string `json:"memory"`
}

SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding includes the requested fields of the GraphQL type SkillFinding. The GraphQL type's documentation follows.

One lint result, carrying the node and memory so a renderer never looks them back up.

func (*SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetMemory added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetMemory() string

GetMemory returns SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding.Memory, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetMessage added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetMessage() string

GetMessage returns SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding.Message, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetRule added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetRule() string

GetRule returns SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding.Rule, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetSeverity added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetSeverity() string

GetSeverity returns SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding.Severity, and is useful for accessing the field via an interface.

func (*SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetUrn added in v0.16.0 

func (v *SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding) GetUrn() string

GetUrn returns SkillExportPlanSkillPlanUnrecognizedFindingsSkillFinding.Urn, and is useful for accessing the field via an interface.

type SkillFileFactsInput added in v0.15.0 

type SkillFileFactsInput struct {
	// The directory the skill occupies — compared against the node's stored name.
	DirName string `json:"dirName"`
	// The hash the client computed over the file itself.
	FileHash *string `json:"fileHash,omitempty"`
	// True when the file carries frontmatter keys the renderer never writes.
	HasExtraFrontmatter *bool `json:"hasExtraFrontmatter,omitempty"`
	// The hash value from the header; omit for a legacy header that carries none.
	HeaderHash *string `json:"headerHash,omitempty"`
	// The id value from the provenance header; omit on a header generation that predates it.
	NodeId *string `json:"nodeId,omitempty"`
	// True when the file exists and could not be parsed.
	ParseFailed *bool `json:"parseFailed,omitempty"`
	// The positive rev=N value from provenance. Null means an older artifact omitted it.
	Revision *int `json:"revision,omitempty"`
	// The source URN from the provenance header.
	SourceUrn *string `json:"sourceUrn,omitempty"`
}

What the client saw of ONE file on disk. The server never reads the caller's disk.

func (*SkillFileFactsInput) GetDirName added in v0.15.0 

func (v *SkillFileFactsInput) GetDirName() string

GetDirName returns SkillFileFactsInput.DirName, and is useful for accessing the field via an interface.

func (*SkillFileFactsInput) GetFileHash added in v0.15.0 

func (v *SkillFileFactsInput) GetFileHash() *string

GetFileHash returns SkillFileFactsInput.FileHash, and is useful for accessing the field via an interface.

func (*SkillFileFactsInput) GetHasExtraFrontmatter added in v0.15.0 

func (v *SkillFileFactsInput) GetHasExtraFrontmatter() *bool

GetHasExtraFrontmatter returns SkillFileFactsInput.HasExtraFrontmatter, and is useful for accessing the field via an interface.

func (*SkillFileFactsInput) GetHeaderHash added in v0.15.0 

func (v *SkillFileFactsInput) GetHeaderHash() *string

GetHeaderHash returns SkillFileFactsInput.HeaderHash, and is useful for accessing the field via an interface.

func (*SkillFileFactsInput) GetNodeId added in v0.15.0 

func (v *SkillFileFactsInput) GetNodeId() *string

GetNodeId returns SkillFileFactsInput.NodeId, and is useful for accessing the field via an interface.

func (*SkillFileFactsInput) GetParseFailed added in v0.15.0 

func (v *SkillFileFactsInput) GetParseFailed() *bool

GetParseFailed returns SkillFileFactsInput.ParseFailed, and is useful for accessing the field via an interface.

func (*SkillFileFactsInput) GetRevision added in v0.18.0 

func (v *SkillFileFactsInput) GetRevision() *int

GetRevision returns SkillFileFactsInput.Revision, and is useful for accessing the field via an interface.

func (*SkillFileFactsInput) GetSourceUrn added in v0.15.0 

func (v *SkillFileFactsInput) GetSourceUrn() *string

GetSourceUrn returns SkillFileFactsInput.SourceUrn, and is useful for accessing the field via an interface.

type SkillPlanInput added in v0.15.0 

type SkillPlanInput struct {
	// What the client found on disk. Empty for lint, which touches no disk.
	Files []*SkillFileFactsInput `json:"files,omitempty"`
	// With EXPORT only, explicitly override local-edit or missing-provenance-ID protection for this invocation.
	Force *bool `json:"force,omitempty"`
	// Target host, named by its D12 declaration key verbatim: claudeSkill (the default) or codexSkill. One host per call; the plan reads that host's declaration and applies its limits, and the retired top-level skill/claudeSkill keys alias to claudeSkill only. An unknown host is refused with BAD_USER_INPUT naming the supported hosts, never judged as another host and never answered with an empty plan.
	Host   *string         `json:"host,omitempty"`
	Intent SkillPlanIntent `json:"intent"`
	// Memory refs for LINT/STATUS only. EXPORT refuses this field, even an empty list.
	Memories []string `json:"memories,omitempty"`
	// Persisted Scope ID for a narrowed EXPORT. Omit for unscoped export; explicit null refuses. Membership is resolved afresh for each call.
	ScopeRef *string `json:"scopeRef,omitempty"`
}

func (*SkillPlanInput) GetFiles added in v0.15.0 

func (v *SkillPlanInput) GetFiles() []*SkillFileFactsInput

GetFiles returns SkillPlanInput.Files, and is useful for accessing the field via an interface.

func (*SkillPlanInput) GetForce added in v0.16.0 

func (v *SkillPlanInput) GetForce() *bool

GetForce returns SkillPlanInput.Force, and is useful for accessing the field via an interface.

func (*SkillPlanInput) GetHost added in v0.15.0 

func (v *SkillPlanInput) GetHost() *string

GetHost returns SkillPlanInput.Host, and is useful for accessing the field via an interface.

func (*SkillPlanInput) GetIntent added in v0.15.0 

func (v *SkillPlanInput) GetIntent() SkillPlanIntent

GetIntent returns SkillPlanInput.Intent, and is useful for accessing the field via an interface.

func (*SkillPlanInput) GetMemories added in v0.15.0 

func (v *SkillPlanInput) GetMemories() []string

GetMemories returns SkillPlanInput.Memories, and is useful for accessing the field via an interface.

func (*SkillPlanInput) GetScopeRef added in v0.18.0 

func (v *SkillPlanInput) GetScopeRef() *string

GetScopeRef returns SkillPlanInput.ScopeRef, and is useful for accessing the field via an interface.

type SkillPlanIntent added in v0.15.0 

type SkillPlanIntent string

What the caller intends to do with the plan. It decides the ACTION, never the class. 

const (
	// Classes, findings, and the rendered body for anything the client should write.
	SkillPlanIntentExport SkillPlanIntent = "EXPORT"
	// Corpus judgment only: findings, no files consulted, no bodies returned.
	SkillPlanIntentLint SkillPlanIntent = "LINT"
	// Classes and findings for files the client found. Never returns a body.
	SkillPlanIntentStatus SkillPlanIntent = "STATUS"
)

type SkillPlanResponse added in v0.15.0 

type SkillPlanResponse struct {
	// #1177 section 3 — the SKILL SEAM: the server judges, the client does I/O.
	//
	// One surface serving skill lint, skill status and skill export. The client
	// sends what it can see of each file on disk; the server returns a drift
	// CLASS and the lint findings per declared node, plus the rendered body for
	// anything the client is to write.
	//
	// A QUERY, not a mutation, and that is the contract. Nothing here writes to a
	// node — publishing is one-way, and the only writer in the feature is the
	// client's own filesystem. So status and lint cannot write by construction
	// rather than by promise.
	//
	// The client cannot name a drift class: the vocabulary is the server's, so it
	// cannot drift between clients. A node failing lint is never given a rendered
	// body, so a client cannot write a file the server judged broken.
	SkillPlan *SkillPlanSkillPlan `json:"skillPlan"`
}

SkillPlanResponse is returned by SkillPlan on success.

func SkillPlan added in v0.15.0 

func SkillPlan(
	ctx_ context.Context,
	client_ graphql.Client,
	input *SkillPlanInput,
) (data_ *SkillPlanResponse, err_ error)

`force` is read with EXPORT only (its SDL description) and nothing here sets it, so it must be OMITTED rather than sent as `null` (#656). `revision` (#1323, the header's rev=N) is new in hadron-server#1339: a server without it rejects the field outright, so it must be OMITTED when the file carries none, never sent as `null` — or every status/export against an older server fails, whatever its files say.

func (*SkillPlanResponse) GetSkillPlan added in v0.15.0 

func (v *SkillPlanResponse) GetSkillPlan() *SkillPlanSkillPlan

GetSkillPlan returns SkillPlanResponse.SkillPlan, and is useful for accessing the field via an interface.

type SkillPlanSkillPlan added in v0.15.0 

type SkillPlanSkillPlan struct {
	// How many nodes carrying ANY declaration key were in scope. A plan over an
	// empty corpus and a plan the caller cannot see are otherwise the same empty
	// list, and a client that cannot tell them apart reports nothing-to-do for a
	// corpus it was denied.
	Scanned int `json:"scanned"`
	// How many of those were judged for THIS host — the number of entries. A node
	// declaring only another host is scanned and not judged, so the two differ by
	// design; the gap is a fact about the corpus, not a discrepancy.
	Judged  int                                        `json:"judged"`
	Entries []*SkillPlanSkillPlanEntriesSkillPlanEntry `json:"entries"`
	Orphans []*SkillPlanSkillPlanOrphansSkillOrphan    `json:"orphans"`
}

SkillPlanSkillPlan includes the requested fields of the GraphQL type SkillPlan.

func (*SkillPlanSkillPlan) GetEntries added in v0.15.0 

func (v *SkillPlanSkillPlan) GetEntries() []*SkillPlanSkillPlanEntriesSkillPlanEntry

GetEntries returns SkillPlanSkillPlan.Entries, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlan) GetJudged added in v0.15.0 

func (v *SkillPlanSkillPlan) GetJudged() int

GetJudged returns SkillPlanSkillPlan.Judged, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlan) GetOrphans added in v0.15.0 

func (v *SkillPlanSkillPlan) GetOrphans() []*SkillPlanSkillPlanOrphansSkillOrphan

GetOrphans returns SkillPlanSkillPlan.Orphans, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlan) GetScanned added in v0.15.0 

func (v *SkillPlanSkillPlan) GetScanned() int

GetScanned returns SkillPlanSkillPlan.Scanned, and is useful for accessing the field via an interface.

type SkillPlanSkillPlanEntriesSkillPlanEntry added in v0.15.0 

type SkillPlanSkillPlanEntriesSkillPlanEntry struct {
	Urn    string `json:"urn"`
	NodeId string `json:"nodeId"`
	// The stored skill name (D12 retired derivation).
	Name string `json:"name"`
	// One of: current, stale, locally-edited, renamed, never-exported, orphaned,
	// unhashed, collision, unavailable, disabled. Null when the file could not be
	// parsed — a parse failure is reported as a FAILURE, not as a class.
	Class *string `json:"class"`
	// True when the file exists and does not parse. Reported identically by status and export.
	ParseFailure bool `json:"parseFailure"`
	// Why an enabled source is out of export in STATUS or EXPORT, or null when this category does not apply. Separate from the planned filesystem action.
	OutOfExportReason *string `json:"outOfExportReason"`
	// Source directory selected for a MOVE or REMOVE action; also reported for the renamed class.
	MovedFrom *string                                                        `json:"movedFrom"`
	Findings  []*SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding `json:"findings"`
}

SkillPlanSkillPlanEntriesSkillPlanEntry includes the requested fields of the GraphQL type SkillPlanEntry.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetClass added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetClass() *string

GetClass returns SkillPlanSkillPlanEntriesSkillPlanEntry.Class, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetFindings added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetFindings() []*SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding

GetFindings returns SkillPlanSkillPlanEntriesSkillPlanEntry.Findings, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetMovedFrom added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetMovedFrom() *string

GetMovedFrom returns SkillPlanSkillPlanEntriesSkillPlanEntry.MovedFrom, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetName added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetName() string

GetName returns SkillPlanSkillPlanEntriesSkillPlanEntry.Name, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetNodeId added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetNodeId() string

GetNodeId returns SkillPlanSkillPlanEntriesSkillPlanEntry.NodeId, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetOutOfExportReason added in v0.18.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetOutOfExportReason() *string

GetOutOfExportReason returns SkillPlanSkillPlanEntriesSkillPlanEntry.OutOfExportReason, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetParseFailure added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetParseFailure() bool

GetParseFailure returns SkillPlanSkillPlanEntriesSkillPlanEntry.ParseFailure, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntry) GetUrn added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntry) GetUrn() string

GetUrn returns SkillPlanSkillPlanEntriesSkillPlanEntry.Urn, and is useful for accessing the field via an interface.

type SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding added in v0.15.0 

type SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding struct {
	Rule string `json:"rule"`
	// Either error or warning — the same vocabulary spec lint renders.
	Severity string `json:"severity"`
	Message  string `json:"message"`
	Urn      string `json:"urn"`
	Memory   string `json:"memory"`
}

SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding includes the requested fields of the GraphQL type SkillFinding. The GraphQL type's documentation follows.

One lint result, carrying the node and memory so a renderer never looks them back up.

func (*SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMemory added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMemory() string

GetMemory returns SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Memory, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMessage added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetMessage() string

GetMessage returns SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Message, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetRule added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetRule() string

GetRule returns SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Rule, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetSeverity added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetSeverity() string

GetSeverity returns SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Severity, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetUrn added in v0.15.0 

func (v *SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding) GetUrn() string

GetUrn returns SkillPlanSkillPlanEntriesSkillPlanEntryFindingsSkillFinding.Urn, and is useful for accessing the field via an interface.

type SkillPlanSkillPlanOrphansSkillOrphan added in v0.15.0 

type SkillPlanSkillPlanOrphansSkillOrphan struct {
	DirName   string  `json:"dirName"`
	NodeId    *string `json:"nodeId"`
	SourceUrn *string `json:"sourceUrn"`
}

SkillPlanSkillPlanOrphansSkillOrphan includes the requested fields of the GraphQL type SkillOrphan. The GraphQL type's documentation follows.

A file that paired with no declared node. Never removed without an explicit prune.

func (*SkillPlanSkillPlanOrphansSkillOrphan) GetDirName added in v0.15.0 

func (v *SkillPlanSkillPlanOrphansSkillOrphan) GetDirName() string

GetDirName returns SkillPlanSkillPlanOrphansSkillOrphan.DirName, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanOrphansSkillOrphan) GetNodeId added in v0.15.0 

func (v *SkillPlanSkillPlanOrphansSkillOrphan) GetNodeId() *string

GetNodeId returns SkillPlanSkillPlanOrphansSkillOrphan.NodeId, and is useful for accessing the field via an interface.

func (*SkillPlanSkillPlanOrphansSkillOrphan) GetSourceUrn added in v0.15.0 

func (v *SkillPlanSkillPlanOrphansSkillOrphan) GetSourceUrn() *string

GetSourceUrn returns SkillPlanSkillPlanOrphansSkillOrphan.SourceUrn, and is useful for accessing the field via an interface.

type SoftDeleteAssetResponse added in v0.9.0 

type SoftDeleteAssetResponse struct {
	SoftDeleteAsset *SoftDeleteAssetSoftDeleteAsset `json:"softDeleteAsset"`
}

SoftDeleteAssetResponse is returned by SoftDeleteAsset on success.

func SoftDeleteAsset added in v0.9.0 

func SoftDeleteAsset(
	ctx_ context.Context,
	client_ graphql.Client,
	assetId string,
) (data_ *SoftDeleteAssetResponse, err_ error)

Soft delete: recoverable via restoreAsset within the retention window, which is why the CLI's `rm` does not describe itself as permanent.

func (*SoftDeleteAssetResponse) GetSoftDeleteAsset added in v0.9.0 

func (v *SoftDeleteAssetResponse) GetSoftDeleteAsset() *SoftDeleteAssetSoftDeleteAsset

GetSoftDeleteAsset returns SoftDeleteAssetResponse.SoftDeleteAsset, and is useful for accessing the field via an interface.

type SoftDeleteAssetSoftDeleteAsset added in v0.9.0 

type SoftDeleteAssetSoftDeleteAsset struct {
	Id string `json:"id"`
	// The asset's URN, grammar v2 (cor:urn:010:01): hrn:asset:<root>:<mem...>:assets:<asset.id>,
	// emitted by emitAssetUrnV2 from the holding memory's STORED urn.
	//
	// <mem...> is one or more atoms, not always one. A per-user memory urn minted
	// before the #697 Stage-3 flip is still compound (<root>:<agent>:app-user:<id>
	// and friends), and each extra memory atom lengthens the asset URN with it —
	// so the 'assets' marker is not at a fixed offset. A parser recovering the
	// holding memory must take everything between the type word and that marker,
	// never a fixed two-atom prefix. Prefer locating the LAST 'assets' atom and
	// reading the id after it (assetIdFromRef does exactly this).
	//
	// Two degraded shapes a parser must tolerate, both of which really occur:
	// * hrn:asset:unknown:assets:<asset.id> — the holding memory row could not
	// be loaded. Carries no memory identity at all.
	// * <memory.urn>:assets:<asset.id> — the pre-#697 shape, with NO hrn:asset:
	// prefix, served when v2 emission throws (empty, over-length or
	// charset-invalid atom in the stored memory urn). It interpolates the
	// stored memory urn verbatim, which is normally bare (<root>:<slug>), so
	// this shape usually looks like acme.com:docs:assets:<id>.
	//
	// A third oddity is reachable through the NORMAL branch, not a fallback: a
	// legacy memories.urn row that predates the chk_memory_urn_not_prefixed
	// guardrail can still hold a rendered hrn:mem:-prefixed value, and that
	// composes into hrn:asset:hrn:mem:<root>:<slug>:assets:<id>. A prefix strip
	// that assumes one leading type word will mis-read it.
	Urn       string  `json:"urn"`
	Filename  string  `json:"filename"`
	DeletedAt *string `json:"deletedAt"`
}

SoftDeleteAssetSoftDeleteAsset includes the requested fields of the GraphQL type Asset.

func (*SoftDeleteAssetSoftDeleteAsset) GetDeletedAt added in v0.9.0 

func (v *SoftDeleteAssetSoftDeleteAsset) GetDeletedAt() *string

GetDeletedAt returns SoftDeleteAssetSoftDeleteAsset.DeletedAt, and is useful for accessing the field via an interface.

func (*SoftDeleteAssetSoftDeleteAsset) GetFilename added in v0.9.0 

func (v *SoftDeleteAssetSoftDeleteAsset) GetFilename() string

GetFilename returns SoftDeleteAssetSoftDeleteAsset.Filename, and is useful for accessing the field via an interface.

func (*SoftDeleteAssetSoftDeleteAsset) GetId added in v0.9.0 

func (v *SoftDeleteAssetSoftDeleteAsset) GetId() string

GetId returns SoftDeleteAssetSoftDeleteAsset.Id, and is useful for accessing the field via an interface.

func (*SoftDeleteAssetSoftDeleteAsset) GetUrn added in v0.9.0 

func (v *SoftDeleteAssetSoftDeleteAsset) GetUrn() string

GetUrn returns SoftDeleteAssetSoftDeleteAsset.Urn, and is useful for accessing the field via an interface.

type SpecBacklinksResponse added in v0.18.0 

type SpecBacklinksResponse struct {
	// #1449 — what refers to the spec at loc in a spec corpus (any memory since
	// #1591): node URNs in the corpus text (inside URLs too) plus real edges from
	// corpus nodes. Exact citation, not descendants. memoryRef accepts the
	// memory's ID or URN.
	SpecBacklinks []*SpecBacklinksSpecBacklinksSpecReference `json:"specBacklinks"`
}

SpecBacklinksResponse is returned by SpecBacklinks on success. 

func SpecBacklinks(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	loc string,
) (data_ *SpecBacklinksResponse, err_ error)

#1449 — what refers to the spec at loc: node URNs in the corpus text (inside URLs too) plus real edges from corpus nodes. Exact citation only. 

func (v *SpecBacklinksResponse) GetSpecBacklinks() []*SpecBacklinksSpecBacklinksSpecReference

GetSpecBacklinks returns SpecBacklinksResponse.SpecBacklinks, and is useful for accessing the field via an interface.

type SpecBacklinksSpecBacklinksSpecReference added in v0.18.0 

type SpecBacklinksSpecBacklinksSpecReference struct {
	Kind SpecReferenceKind `json:"kind"`
	// The scanned field; edge for a real edge; pendingEdge for an edge whose target is not a node yet.
	Field        string `json:"field"`
	SourceLoc    string `json:"sourceLoc"`
	SourceNodeId string `json:"sourceNodeId"`
	// The cited loc; for an edge into another memory, the target's node URN; for a pendingEdge not yet resolved to a node, its target as recorded (a loc, file id or URN).
	TargetLoc string  `json:"targetLoc"`
	Text      *string `json:"text"`
}

SpecBacklinksSpecBacklinksSpecReference includes the requested fields of the GraphQL type SpecReference. The GraphQL type's documentation follows.

#1449 — one reference to a spec in a draft corpus. For kind URN, field is the text field it was found in and text the URN as written; for kind EDGE, field is 'edge' and text the edge's relationship name.

func (*SpecBacklinksSpecBacklinksSpecReference) GetField added in v0.18.0 

func (v *SpecBacklinksSpecBacklinksSpecReference) GetField() string

GetField returns SpecBacklinksSpecBacklinksSpecReference.Field, and is useful for accessing the field via an interface.

func (*SpecBacklinksSpecBacklinksSpecReference) GetKind added in v0.18.0 

func (v *SpecBacklinksSpecBacklinksSpecReference) GetKind() SpecReferenceKind

GetKind returns SpecBacklinksSpecBacklinksSpecReference.Kind, and is useful for accessing the field via an interface.

func (*SpecBacklinksSpecBacklinksSpecReference) GetSourceLoc added in v0.18.0 

func (v *SpecBacklinksSpecBacklinksSpecReference) GetSourceLoc() string

GetSourceLoc returns SpecBacklinksSpecBacklinksSpecReference.SourceLoc, and is useful for accessing the field via an interface.

func (*SpecBacklinksSpecBacklinksSpecReference) GetSourceNodeId added in v0.18.0 

func (v *SpecBacklinksSpecBacklinksSpecReference) GetSourceNodeId() string

GetSourceNodeId returns SpecBacklinksSpecBacklinksSpecReference.SourceNodeId, and is useful for accessing the field via an interface.

func (*SpecBacklinksSpecBacklinksSpecReference) GetTargetLoc added in v0.18.0 

func (v *SpecBacklinksSpecBacklinksSpecReference) GetTargetLoc() string

GetTargetLoc returns SpecBacklinksSpecBacklinksSpecReference.TargetLoc, and is useful for accessing the field via an interface.

func (*SpecBacklinksSpecBacklinksSpecReference) GetText added in v0.18.0 

func (v *SpecBacklinksSpecBacklinksSpecReference) GetText() *string

GetText returns SpecBacklinksSpecBacklinksSpecReference.Text, and is useful for accessing the field via an interface.

type SpecCorpusStateMemory added in v0.18.0 

type SpecCorpusStateMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn string `json:"urn"`
	// #1447/#1448, derived per node since #1591 — DRAFT while none of this
	// memory's live nodes is minted, MINTED once any is. Draft rights are per
	// node: an unminted node can be renumbered, moved without a URN alias, and
	// bulk-replaced, in any memory (see Node.mintStatus).
	CorpusState CorpusState `json:"corpusState"`
	// #1448/#1591 — the latest mint time among this memory's live nodes; null while none is minted.
	CorpusMintedAt *string `json:"corpusMintedAt"`
}

SpecCorpusStateMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*SpecCorpusStateMemory) GetCorpusMintedAt added in v0.18.0 

func (v *SpecCorpusStateMemory) GetCorpusMintedAt() *string

GetCorpusMintedAt returns SpecCorpusStateMemory.CorpusMintedAt, and is useful for accessing the field via an interface.

func (*SpecCorpusStateMemory) GetCorpusState added in v0.18.0 

func (v *SpecCorpusStateMemory) GetCorpusState() CorpusState

GetCorpusState returns SpecCorpusStateMemory.CorpusState, and is useful for accessing the field via an interface.

func (*SpecCorpusStateMemory) GetId added in v0.18.0 

func (v *SpecCorpusStateMemory) GetId() string

GetId returns SpecCorpusStateMemory.Id, and is useful for accessing the field via an interface.

func (*SpecCorpusStateMemory) GetUrn added in v0.18.0 

func (v *SpecCorpusStateMemory) GetUrn() string

GetUrn returns SpecCorpusStateMemory.Urn, and is useful for accessing the field via an interface.

type SpecCorpusStateResponse added in v0.18.0 

type SpecCorpusStateResponse struct {
	// Fetch a single Memory (org member, shared-read gate, or platform ADMIN).
	// Missing and unreadable refs both return null without an error, so a caller
	// cannot use this field to test whether a private memory exists. Malformed
	// refs still fail as caller errors, and operational faults still propagate.
	//
	// 'ref' accepts the entity's ID or URN.
	Memory *SpecCorpusStateMemory `json:"memory"`
}

SpecCorpusStateResponse is returned by SpecCorpusState on success.

func SpecCorpusState added in v0.18.0 

func SpecCorpusState(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *SpecCorpusStateResponse, err_ error)

The corpus state of one memory — `spec describe` reads it.

func (*SpecCorpusStateResponse) GetMemory added in v0.18.0 

func (v *SpecCorpusStateResponse) GetMemory() *SpecCorpusStateMemory

GetMemory returns SpecCorpusStateResponse.Memory, and is useful for accessing the field via an interface.

type SpecMintFindingKind added in v0.18.0 

type SpecMintFindingKind string

#1448 — why the mint report lists an item. 

const (
	// #1591 — an edge into another memory's node that is not minted yet (targetLoc is its URN).
	SpecMintFindingKindCitesUnminted SpecMintFindingKind = "CITES_UNMINTED"
	// A structural lint error (rule: nodetype-info | tag-spec | serialization-leak | duplicate-loc).
	SpecMintFindingKindLint SpecMintFindingKind = "LINT"
	// #1591 — the node's current revision is not approved.
	SpecMintFindingKindNotApproved SpecMintFindingKind = "NOT_APPROVED"
	// A reserved citation with no spec written yet.
	SpecMintFindingKindPlaceholder SpecMintFindingKind = "PLACEHOLDER"
	// An abstract written for an earlier body.
	SpecMintFindingKindStaleAbstract SpecMintFindingKind = "STALE_ABSTRACT"
	// #1591 — the approved revision's text changed outside the revision system, so it no longer matches its approval hash. Re-approve it.
	SpecMintFindingKindTampered SpecMintFindingKind = "TAMPERED"
	// A reference to a spec that does not exist, or to a placeholder (rule: MISSING | PLACEHOLDER).
	SpecMintFindingKindUnresolvedReference SpecMintFindingKind = "UNRESOLVED_REFERENCE"
)

type SpecPlaceholderScanFindNodesFindNodesResult added in v0.18.0 

type SpecPlaceholderScanFindNodesFindNodesResult struct {
	Hits []*SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit `json:"hits"`
}

SpecPlaceholderScanFindNodesFindNodesResult includes the requested fields of the GraphQL type FindNodesResult. The GraphQL type's documentation follows.

Envelope for findNodes (cor:api:090) — the unified node list + search field (it replaced the removed nodes + nodeSearch queries). hits carry per-hit score + vector metadata; passages carry chunk-granularity results; reason/degraded surface no-index / reduced-fidelity outcomes.

func (*SpecPlaceholderScanFindNodesFindNodesResult) GetHits added in v0.18.0 

func (v *SpecPlaceholderScanFindNodesFindNodesResult) GetHits() []*SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit

GetHits returns SpecPlaceholderScanFindNodesFindNodesResult.Hits, and is useful for accessing the field via an interface.

type SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit added in v0.18.0 

type SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit struct {
	Node *SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode `json:"node"`
}

SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit includes the requested fields of the GraphQL type NodeHit. The GraphQL type's documentation follows.

A scored node hit (cor:api:090:04). score is null for an unscored filtered list (no query).

func (*SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit) GetNode added in v0.18.0 

func (v *SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit) GetNode() *SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode

GetNode returns SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHit.Node, and is useful for accessing the field via an interface.

type SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode added in v0.18.0 

type SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode struct {
	Loc string `json:"loc"`
	// #1450 — true for a RESERVED spec citation that has no spec written yet (a
	// placeholder in a draft corpus, created by reserveSpecCitation). Set only by
	// the server, never inferred from an empty body; writing real content through
	// updateSpecNode clears it. Minting refuses while any remain.
	IsPlaceholder bool `json:"isPlaceholder"`
}

SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode includes the requested fields of the GraphQL type Node.

func (*SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode) GetIsPlaceholder added in v0.18.0 

func (v *SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode) GetIsPlaceholder() bool

GetIsPlaceholder returns SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode.IsPlaceholder, and is useful for accessing the field via an interface.

func (*SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode) GetLoc added in v0.18.0 

func (v *SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode) GetLoc() string

GetLoc returns SpecPlaceholderScanFindNodesFindNodesResultHitsNodeHitNode.Loc, and is useful for accessing the field via an interface.

type SpecPlaceholderScanResponse added in v0.18.0 

type SpecPlaceholderScanResponse struct {
	// Unified node search (cor:api:090) — the single node list + retrieval
	// surface (it replaced the removed `nodes` filter/list and `nodeSearch`
	// rank queries in PR3). Omit `query` for a filtered list in deterministic
	// order (subsumes `nodes`); pass `query` to rank by `mode`
	// (keyword | vector | hybrid | regex). Lexical modes honor boolean operators
	// (`(a OR b) AND c`, quoted phrases, NOT/-) — operator words are
	// UPPERCASE-ONLY, so natural phrases like 'not sure' search literally —
	// and `fields` as a ranking weight-mask. Malformed boolean syntax
	// (unmatched parenthesis, unterminated quote) DEGRADES to a literal phrase
	// search flagged `degraded: 'literal_fallback'` instead of erroring; only
	// mode: regex fails loudly on bad syntax. `filter` is the structured, AND-combined filter context
	// (SYSTEM memory class excluded by default; explicit wins). Returns a
	// scored-hit envelope. Access-scoped identically to the per-kind node queries.
	//
	// orgId (optional) narrows the accessible scope to a single organization the
	// caller is a member of; a non-member orgId returns an empty envelope
	// (total 0, no existence disclosure). Combined with filter.isRunnable: true
	// this is the canonical "the caller's runnable task nodes in one org" query
	// (there is no separate myTasks surface — a task is simply an isRunnable node).
	FindNodes *SpecPlaceholderScanFindNodesFindNodesResult `json:"findNodes"`
}

SpecPlaceholderScanResponse is returned by SpecPlaceholderScan on success.

func SpecPlaceholderScan added in v0.18.0 

func SpecPlaceholderScan(
	ctx_ context.Context,
	client_ graphql.Client,
	filter *NodeFilter,
	sort NodeSort,
	limit int,
	offset int,
) (data_ *SpecPlaceholderScanResponse, err_ error)

#1450 — which specs in a DRAFT corpus are placeholders. A separate, minimal scan run only for a draft, so the shared node projections don't select isPlaceholder: an older server would reject every spec read over it. Keep NodeFilter omission semantics even when genqlient discovers this operation before FindNodes during generation.

func (*SpecPlaceholderScanResponse) GetFindNodes added in v0.18.0 

func (v *SpecPlaceholderScanResponse) GetFindNodes() *SpecPlaceholderScanFindNodesFindNodesResult

GetFindNodes returns SpecPlaceholderScanResponse.FindNodes, and is useful for accessing the field via an interface.

type SpecReferenceKind added in v0.18.0 

type SpecReferenceKind string

#1449 — how a spec corpus reference was found. 

const (
	// A real edge from a corpus node.
	SpecReferenceKindEdge SpecReferenceKind = "EDGE"
	// A node URN in the corpus text (name, description, abstract or content), including inside a URL.
	SpecReferenceKindUrn SpecReferenceKind = "URN"
)

type SpecReferenceProblem added in v0.18.0 

type SpecReferenceProblem string

#1449 — why a reference does not reach a written spec. 

const (
	// No live node at the cited loc.
	SpecReferenceProblemMissing SpecReferenceProblem = "MISSING"
	// The cited node is a placeholder: a reserved citation with no spec written yet.
	SpecReferenceProblemPlaceholder SpecReferenceProblem = "PLACEHOLDER"
)

type SpecRewriteStatus added in v0.18.0 

type SpecRewriteStatus string

#1449 — state of one node's reference rewrite in a renumber. 

const (
	// The rewrite was refused or kept conflicting; error says why. The move itself stands.
	SpecRewriteStatusFailed SpecRewriteStatus = "FAILED"
	// Dry run: this rewrite would be made.
	SpecRewriteStatusPlanned   SpecRewriteStatus = "PLANNED"
	SpecRewriteStatusRewritten SpecRewriteStatus = "REWRITTEN"
	// A concurrent edit removed the references (or the node) before the rewrite, so nothing was written.
	SpecRewriteStatusUnchanged SpecRewriteStatus = "UNCHANGED"
)

type SpecSearchReplaceInput added in v0.18.0 

type SpecSearchReplaceInput struct {
	CaseInsensitive *bool `json:"caseInsensitive"`
	DryRun          *bool `json:"dryRun"`
	// Required for apply; copied from the exact dry-run response.
	ExpectedPlan *string         `json:"expectedPlan,omitempty"`
	Fields       []SpecTextField `json:"fields"`
	// Refuse the entire apply when more nodes would change.
	MaxNodesChanged *int     `json:"maxNodesChanged,omitempty"`
	MemoryRef       string   `json:"memoryRef"`
	NewText         string   `json:"newText"`
	NodeIds         []string `json:"nodeIds"`
	OldText         string   `json:"oldText"`
	Reason          *string  `json:"reason,omitempty"`
	Regex           *bool    `json:"regex"`
	// Literal mode only; matches the CLI's default ASCII word-boundary behavior.
	WordBoundary *bool `json:"wordBoundary"`
}

Replace text in explicit nodes of one DRAFT spec corpus. A dry run returns plan; apply must present that exact plan and refuses if any selected row, protection, match, or corpus state changed. Minted corpora are never edited through this door. Generic replacement keeps its governed-node protections.

func (*SpecSearchReplaceInput) GetCaseInsensitive added in v0.18.0 

func (v *SpecSearchReplaceInput) GetCaseInsensitive() *bool

GetCaseInsensitive returns SpecSearchReplaceInput.CaseInsensitive, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetDryRun added in v0.18.0 

func (v *SpecSearchReplaceInput) GetDryRun() *bool

GetDryRun returns SpecSearchReplaceInput.DryRun, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetExpectedPlan added in v0.18.0 

func (v *SpecSearchReplaceInput) GetExpectedPlan() *string

GetExpectedPlan returns SpecSearchReplaceInput.ExpectedPlan, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetFields added in v0.18.0 

func (v *SpecSearchReplaceInput) GetFields() []SpecTextField

GetFields returns SpecSearchReplaceInput.Fields, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetMaxNodesChanged added in v0.18.0 

func (v *SpecSearchReplaceInput) GetMaxNodesChanged() *int

GetMaxNodesChanged returns SpecSearchReplaceInput.MaxNodesChanged, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetMemoryRef added in v0.18.0 

func (v *SpecSearchReplaceInput) GetMemoryRef() string

GetMemoryRef returns SpecSearchReplaceInput.MemoryRef, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetNewText added in v0.18.0 

func (v *SpecSearchReplaceInput) GetNewText() string

GetNewText returns SpecSearchReplaceInput.NewText, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetNodeIds added in v0.18.0 

func (v *SpecSearchReplaceInput) GetNodeIds() []string

GetNodeIds returns SpecSearchReplaceInput.NodeIds, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetOldText added in v0.18.0 

func (v *SpecSearchReplaceInput) GetOldText() string

GetOldText returns SpecSearchReplaceInput.OldText, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetReason added in v0.18.0 

func (v *SpecSearchReplaceInput) GetReason() *string

GetReason returns SpecSearchReplaceInput.Reason, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetRegex added in v0.18.0 

func (v *SpecSearchReplaceInput) GetRegex() *bool

GetRegex returns SpecSearchReplaceInput.Regex, and is useful for accessing the field via an interface.

func (*SpecSearchReplaceInput) GetWordBoundary added in v0.18.0 

func (v *SpecSearchReplaceInput) GetWordBoundary() *bool

GetWordBoundary returns SpecSearchReplaceInput.WordBoundary, and is useful for accessing the field via an interface.

type SpecTextField added in v0.18.0 

type SpecTextField string

Only text fields a spec bulk edit may change. 

const (
	SpecTextFieldAbstract SpecTextField = "abstract"
	SpecTextFieldContent  SpecTextField = "content"
)

type SpecUnresolvedReferencesResponse added in v0.18.0 

type SpecUnresolvedReferencesResponse struct {
	// #1449 — references in a spec corpus (any memory since #1591) that do not reach a written
	// spec: URNs citing a missing loc or a placeholder, edges to a
	// placeholder or to a deleted spec of the corpus, and pending edges (field pendingEdge) whose target is not
	// a written node yet. Minting refuses while any remain.
	SpecUnresolvedReferences []*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference `json:"specUnresolvedReferences"`
}

SpecUnresolvedReferencesResponse is returned by SpecUnresolvedReferences on success.

func SpecUnresolvedReferences added in v0.18.0 

func SpecUnresolvedReferences(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
) (data_ *SpecUnresolvedReferencesResponse, err_ error)

#1449 — references that do not reach a written spec. Minting refuses while any remain.

func (*SpecUnresolvedReferencesResponse) GetSpecUnresolvedReferences added in v0.18.0 

func (v *SpecUnresolvedReferencesResponse) GetSpecUnresolvedReferences() []*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference

GetSpecUnresolvedReferences returns SpecUnresolvedReferencesResponse.SpecUnresolvedReferences, and is useful for accessing the field via an interface.

type SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference added in v0.18.0 

type SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference struct {
	Kind SpecReferenceKind `json:"kind"`
	// The scanned field; edge for a real edge; pendingEdge for an edge whose target is not a node yet.
	Field string `json:"field"`
	// Set only by specUnresolvedReferences.
	Reason       *SpecReferenceProblem `json:"reason"`
	SourceLoc    string                `json:"sourceLoc"`
	SourceNodeId string                `json:"sourceNodeId"`
	// The cited loc; for an edge into another memory, the target's node URN; for a pendingEdge not yet resolved to a node, its target as recorded (a loc, file id or URN).
	TargetLoc string  `json:"targetLoc"`
	Text      *string `json:"text"`
}

SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference includes the requested fields of the GraphQL type SpecReference. The GraphQL type's documentation follows.

#1449 — one reference to a spec in a draft corpus. For kind URN, field is the text field it was found in and text the URN as written; for kind EDGE, field is 'edge' and text the edge's relationship name.

func (*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetField added in v0.18.0 

func (v *SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetField() string

GetField returns SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference.Field, and is useful for accessing the field via an interface.

func (*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetKind added in v0.18.0 

func (v *SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetKind() SpecReferenceKind

GetKind returns SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference.Kind, and is useful for accessing the field via an interface.

func (*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetReason added in v0.18.0 

func (v *SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetReason() *SpecReferenceProblem

GetReason returns SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference.Reason, and is useful for accessing the field via an interface.

func (*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetSourceLoc added in v0.18.0 

func (v *SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetSourceLoc() string

GetSourceLoc returns SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference.SourceLoc, and is useful for accessing the field via an interface.

func (*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetSourceNodeId added in v0.18.0 

func (v *SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetSourceNodeId() string

GetSourceNodeId returns SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference.SourceNodeId, and is useful for accessing the field via an interface.

func (*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetTargetLoc added in v0.18.0 

func (v *SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetTargetLoc() string

GetTargetLoc returns SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference.TargetLoc, and is useful for accessing the field via an interface.

func (*SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetText added in v0.18.0 

func (v *SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference) GetText() *string

GetText returns SpecUnresolvedReferencesSpecUnresolvedReferencesSpecReference.Text, and is useful for accessing the field via an interface.

type StartImpersonationResponse added in v0.9.0 

type StartImpersonationResponse struct {
	// Start impersonating another member of orgRef (admin support/diagnostics).
	// Caller must be a live ADMIN/OWNER of the org (platform ADMIN/OWNER is
	// OWNER-equivalent), the target a live member, PEER-OR-BELOW (an org ADMIN
	// may not impersonate an org OWNER), never self. Returns the audit session
	// and a short-TTL token (returned exactly once) whose requests run
	// READ-ONLY as the target, scoped to this one org: other orgs and all
	// personal-class resources stay invisible, and every mutation except
	// stopImpersonation is rejected. Every request re-validates the session
	// row, so stopping it (or demoting the admin) kills the token immediately.
	StartImpersonation *StartImpersonationStartImpersonationStartImpersonationResult `json:"startImpersonation"`
}

StartImpersonationResponse is returned by StartImpersonation on success.

func StartImpersonation added in v0.9.0 

func StartImpersonation(
	ctx_ context.Context,
	client_ graphql.Client,
	orgRef string,
	userRef string,
	reason *string,
) (data_ *StartImpersonationResponse, err_ error)

Admin impersonation (read-only support sessions). start returns the short-TTL token exactly once; the CLI stores it under a host-derived impersonation key and prefers it in Factory.Token().

func (*StartImpersonationResponse) GetStartImpersonation added in v0.9.0 

func (v *StartImpersonationResponse) GetStartImpersonation() *StartImpersonationStartImpersonationStartImpersonationResult

GetStartImpersonation returns StartImpersonationResponse.StartImpersonation, and is useful for accessing the field via an interface.

type StartImpersonationStartImpersonationStartImpersonationResult added in v0.9.0 

type StartImpersonationStartImpersonationStartImpersonationResult struct {
	Token   string                                                                                   `json:"token"`
	Session *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession `json:"session"`
}

StartImpersonationStartImpersonationStartImpersonationResult includes the requested fields of the GraphQL type StartImpersonationResult. The GraphQL type's documentation follows.

Returned exactly once by startImpersonation — the token is never stored or shown again (UserApiKey rawKey precedent).

func (*StartImpersonationStartImpersonationStartImpersonationResult) GetSession added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResult) GetSession() *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession

GetSession returns StartImpersonationStartImpersonationStartImpersonationResult.Session, and is useful for accessing the field via an interface.

func (*StartImpersonationStartImpersonationStartImpersonationResult) GetToken added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResult) GetToken() string

GetToken returns StartImpersonationStartImpersonationStartImpersonationResult.Token, and is useful for accessing the field via an interface.

type StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession added in v0.9.0 

type StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession struct {
	Id           string                                                                                               `json:"id"`
	ExpiresAt    string                                                                                               `json:"expiresAt"`
	Organization *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization `json:"organization"`
	TargetUser   *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser   `json:"targetUser"`
}

StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession includes the requested fields of the GraphQL type ImpersonationSession. The GraphQL type's documentation follows.

One admin-impersonation session: the durable audit record (who impersonated whom, in which org, when) AND the revocation source of truth (stopImpersonation writes endedAt; rows are never deleted).

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetExpiresAt added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetExpiresAt() string

GetExpiresAt returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession.ExpiresAt, and is useful for accessing the field via an interface.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetId added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetId() string

GetId returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession.Id, and is useful for accessing the field via an interface.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetOrganization added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetOrganization() *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization

GetOrganization returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession.Organization, and is useful for accessing the field via an interface.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetTargetUser added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession) GetTargetUser() *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser

GetTargetUser returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSession.TargetUser, and is useful for accessing the field via an interface.

type StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization added in v0.9.0 

type StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization struct {
	Id   string `json:"id"`
	Name string `json:"name"`
}

StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization) GetId added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization) GetId() string

GetId returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization.Id, and is useful for accessing the field via an interface.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization) GetName added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization) GetName() string

GetName returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionOrganization.Name, and is useful for accessing the field via an interface.

type StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser added in v0.9.0 

type StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser struct {
	Id     string  `json:"id"`
	Handle *string `json:"handle"`
	Name   *string `json:"name"`
}

StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser includes the requested fields of the GraphQL type User.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser) GetHandle added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser) GetHandle() *string

GetHandle returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser.Handle, and is useful for accessing the field via an interface.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser) GetId added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser) GetId() string

GetId returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser.Id, and is useful for accessing the field via an interface.

func (*StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser) GetName added in v0.9.0 

func (v *StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser) GetName() *string

GetName returns StartImpersonationStartImpersonationStartImpersonationResultSessionImpersonationSessionTargetUser.Name, and is useful for accessing the field via an interface.

type StartTeamSessionResponse added in v0.9.0 

type StartTeamSessionResponse struct {
	// Open a session — and, when `input.workerRef` is given, a WORKER SESSION:
	// the binding that makes the work attributable to that named teammate.
	//
	// The binding is held server-side and is independent of the caller's CHAT
	// SESSION (the human's Desktop window, Claude Code session or IDE chat).
	// **Ending your chat session does not end a worker session** (#1034): a chat
	// session that closes leaves this session open until endSession — #1114
	// removed inactivity as a reason to end one, so nothing else will. The worker
	// stops reading as LIVE once its idle window passes without a drive, which
	// lets another bind proceed without ending the stale session or losing its
	// unwritten handoff. A human HOLD stays in force until explicit release, so
	// only its holder can bind it again. A client that ties its lifetime to a
	// conversation must call endSession itself; nothing
	// about closing a window reaches this server.
	StartSession *StartTeamSessionStartSession `json:"startSession"`
}

StartTeamSessionResponse is returned by StartTeamSession on success.

func StartTeamSession added in v0.9.0 

func StartTeamSession(
	ctx_ context.Context,
	client_ graphql.Client,
	input *SessionInput,
) (data_ *StartTeamSessionResponse, err_ error)

All SessionInput fields except id are optional; omitempty keeps an unset flag off the wire entirely (the create treats null and omitted alike, but the omitted form is the repo-wide convention — see CLAUDE.md). appRef (#943) arrived with a schema refresh, and a refreshed input field does NOT inherit the surrounding omitempty — without this line every session start would newly put `"appRef": null` on the wire. workerRef (#974 / cor:agt:020:03) binds the session to the Worker by ID — Session.agentId is stamped server-side from the casting, so the CLI no longer resolves an agent. Same refresh rule as appRef above. force (#940 / hadron-cli#432) is the informed-takeover override: a worker with an ACTIVE session refuses WORKER_TAKEN atomically unless force rides along. Sent only on --force, so the override stays explicit. plan (#934) arrived in the same refresh; the CLI does not drive it yet, but the refreshed field still needs its omitempty line (the #139 trap).

func (*StartTeamSessionResponse) GetStartSession added in v0.9.0 

func (v *StartTeamSessionResponse) GetStartSession() *StartTeamSessionStartSession

GetStartSession returns StartTeamSessionResponse.StartSession, and is useful for accessing the field via an interface.

type StartTeamSessionStartSession added in v0.9.0 

type StartTeamSessionStartSession struct {
	TeamSessionFields `json:"-"`
}

StartTeamSessionStartSession includes the requested fields of the GraphQL type Session. The GraphQL type's documentation follows.

A unit of work recorded against a user or App: the general row, and what the bare word "session" means throughout this schema (#1034). `type` says which kind — DEVELOPER, CHATBOT, AUTOMATION, EDGE — and `workerId` is optional.

A **worker session** is the subtype with `workerId` set: a Worker (named casting) bound to a driver, which is what makes work attributable to a teammate and what a merged PR traces back through. Binding is optional, so a list of these is not a staff view and may hold no worker sessions at all — read `workerId` per row rather than assuming either way.

A **chat session** is NOT one of these and has no row here: it is the conversation a human is in — the Claude Desktop window, the Claude Code session, the IDE chat. The two are independent and **ending one does not end the other**: a chat session that closes leaves its worker session open until endSession. Since #1114 nothing ends it for inactivity — silence is not evidence of abandonment — but it stops reading as LIVE once nobody has driven it inside its idle window, so the stale session stops blocking another bind without being ended or losing its unwritten handoff. That changes no HOLD: a human-held name stays held until explicit release, so only its holder can bind it again. Do not use "chat session" for a Chat (the agent conversation entity) — that is an **agent chat**, a third concept.

func (*StartTeamSessionStartSession) GetAgentId added in v0.9.0 

func (v *StartTeamSessionStartSession) GetAgentId() *string

GetAgentId returns StartTeamSessionStartSession.AgentId, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetAutoExpiredAt added in v0.15.0 

func (v *StartTeamSessionStartSession) GetAutoExpiredAt() *string

GetAutoExpiredAt returns StartTeamSessionStartSession.AutoExpiredAt, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetBranch added in v0.9.0 

func (v *StartTeamSessionStartSession) GetBranch() *string

GetBranch returns StartTeamSessionStartSession.Branch, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetEndedAt added in v0.9.0 

func (v *StartTeamSessionStartSession) GetEndedAt() *string

GetEndedAt returns StartTeamSessionStartSession.EndedAt, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetHost added in v0.9.0 

func (v *StartTeamSessionStartSession) GetHost() *string

GetHost returns StartTeamSessionStartSession.Host, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetId added in v0.9.0 

func (v *StartTeamSessionStartSession) GetId() string

GetId returns StartTeamSessionStartSession.Id, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetLlmModel added in v0.9.0 

func (v *StartTeamSessionStartSession) GetLlmModel() *string

GetLlmModel returns StartTeamSessionStartSession.LlmModel, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetPrNumber added in v0.9.0 

func (v *StartTeamSessionStartSession) GetPrNumber() *int

GetPrNumber returns StartTeamSessionStartSession.PrNumber, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetRepo added in v0.9.0 

func (v *StartTeamSessionStartSession) GetRepo() *string

GetRepo returns StartTeamSessionStartSession.Repo, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetStartedAt added in v0.9.0 

func (v *StartTeamSessionStartSession) GetStartedAt() string

GetStartedAt returns StartTeamSessionStartSession.StartedAt, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetTool added in v0.9.0 

func (v *StartTeamSessionStartSession) GetTool() *string

GetTool returns StartTeamSessionStartSession.Tool, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetTranscriptPath added in v0.9.0 

func (v *StartTeamSessionStartSession) GetTranscriptPath() *string

GetTranscriptPath returns StartTeamSessionStartSession.TranscriptPath, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetType added in v0.9.0 

func (v *StartTeamSessionStartSession) GetType() string

GetType returns StartTeamSessionStartSession.Type, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetUserId added in v0.9.0 

func (v *StartTeamSessionStartSession) GetUserId() *string

GetUserId returns StartTeamSessionStartSession.UserId, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetWorker added in v0.9.0 

func (v *StartTeamSessionStartSession) GetWorker() *TeamSessionFieldsWorker

GetWorker returns StartTeamSessionStartSession.Worker, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) GetWorkerId added in v0.9.0 

func (v *StartTeamSessionStartSession) GetWorkerId() *string

GetWorkerId returns StartTeamSessionStartSession.WorkerId, and is useful for accessing the field via an interface.

func (*StartTeamSessionStartSession) MarshalJSON added in v0.9.0 

func (v *StartTeamSessionStartSession) MarshalJSON() ([]byte, error)

func (*StartTeamSessionStartSession) UnmarshalJSON added in v0.9.0 

func (v *StartTeamSessionStartSession) UnmarshalJSON(b []byte) error

type StopImpersonationResponse added in v0.9.0 

type StopImpersonationResponse struct {
	// Stop an impersonation session (writes endedAt; the audit row is never
	// deleted). With an impersonation token, id may be omitted (ends the
	// token's own session — the one mutation an impersonated context may
	// call). With a normal token, id is required and the caller must be the
	// session's admin, an org ADMIN/OWNER of its org, or a platform admin.
	// Idempotent on an already-ended session.
	StopImpersonation *StopImpersonationStopImpersonationImpersonationSession `json:"stopImpersonation"`
}

StopImpersonationResponse is returned by StopImpersonation on success.

func StopImpersonation added in v0.9.0 

func StopImpersonation(
	ctx_ context.Context,
	client_ graphql.Client,
	id *string,
) (data_ *StopImpersonationResponse, err_ error)

func (*StopImpersonationResponse) GetStopImpersonation added in v0.9.0 

func (v *StopImpersonationResponse) GetStopImpersonation() *StopImpersonationStopImpersonationImpersonationSession

GetStopImpersonation returns StopImpersonationResponse.StopImpersonation, and is useful for accessing the field via an interface.

type StopImpersonationStopImpersonationImpersonationSession added in v0.9.0 

type StopImpersonationStopImpersonationImpersonationSession struct {
	Id string `json:"id"`
	// Explicit-stop timestamp; null while live or when the session merely
	// lapsed by TTL.
	EndedAt *string `json:"endedAt"`
}

StopImpersonationStopImpersonationImpersonationSession includes the requested fields of the GraphQL type ImpersonationSession. The GraphQL type's documentation follows.

One admin-impersonation session: the durable audit record (who impersonated whom, in which org, when) AND the revocation source of truth (stopImpersonation writes endedAt; rows are never deleted).

func (*StopImpersonationStopImpersonationImpersonationSession) GetEndedAt added in v0.9.0 

func (v *StopImpersonationStopImpersonationImpersonationSession) GetEndedAt() *string

GetEndedAt returns StopImpersonationStopImpersonationImpersonationSession.EndedAt, and is useful for accessing the field via an interface.

func (*StopImpersonationStopImpersonationImpersonationSession) GetId added in v0.9.0 

func (v *StopImpersonationStopImpersonationImpersonationSession) GetId() string

GetId returns StopImpersonationStopImpersonationImpersonationSession.Id, and is useful for accessing the field via an interface.

type SyncStatus 

type SyncStatus string
const (
	SyncStatusError   SyncStatus = "ERROR"
	SyncStatusOk      SyncStatus = "OK"
	SyncStatusPending SyncStatus = "PENDING"
	SyncStatusSyncing SyncStatus = "SYNCING"
)

type TeamAppIdentityApp added in v0.10.0 

type TeamAppIdentityApp struct {
	Id   string `json:"id"`
	Urn  string `json:"urn"`
	Name string `json:"name"`
}

TeamAppIdentityApp includes the requested fields of the GraphQL type App. The GraphQL type's documentation follows.

A runtime caller identity owned by exactly one Organization or User. It owns long-lived App Keys and installs Agents through the AppAgent N:M join: one App may install many Agents, and one Agent may be installed in many Apps. The singular agentId / agent fields below are soft-deprecated convenience reads of the first install, not a direct foreign key.

func (*TeamAppIdentityApp) GetId added in v0.10.0 

func (v *TeamAppIdentityApp) GetId() string

GetId returns TeamAppIdentityApp.Id, and is useful for accessing the field via an interface.

func (*TeamAppIdentityApp) GetName added in v0.10.0 

func (v *TeamAppIdentityApp) GetName() string

GetName returns TeamAppIdentityApp.Name, and is useful for accessing the field via an interface.

func (*TeamAppIdentityApp) GetUrn added in v0.10.0 

func (v *TeamAppIdentityApp) GetUrn() string

GetUrn returns TeamAppIdentityApp.Urn, and is useful for accessing the field via an interface.

type TeamAppIdentityResponse added in v0.10.0 

type TeamAppIdentityResponse struct {
	// Fetch an App (member of the App's org, or platform ADMIN — the myApps
	// exposure bar; #473 relaxed this from org ADMIN for read parity with the
	// list).
	//
	// 'ref' accepts the entity's ID or URN.
	App *TeamAppIdentityApp `json:"app"`
}

TeamAppIdentityResponse is returned by TeamAppIdentity on success.

func TeamAppIdentity added in v0.10.0 

func TeamAppIdentity(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
) (data_ *TeamAppIdentityResponse, err_ error)

#458: the READABLE identity of a team App. The ambient App resolution hands back whatever ref answered — often the binding's raw AppID — so a human read that names its App has only a UUID to print. Deliberately three scalars: this runs to decorate a render, never to gate one, so the call site treats a failure as "no readable name" and falls back to the raw ref.

func (*TeamAppIdentityResponse) GetApp added in v0.10.0 

func (v *TeamAppIdentityResponse) GetApp() *TeamAppIdentityApp

GetApp returns TeamAppIdentityResponse.App, and is useful for accessing the field via an interface.

type TeamAttentionPageResponse added in v0.18.0 

type TeamAttentionPageResponse struct {
	// #1384 paged (v2) attention poll — the bounded successor to teamAttention
	// (v1 answers UPGRADE_REQUIRED). Each call decrypts at most scanLimit rows
	// and emits at most limit Worker/Channel pairs; continue with page while
	// nextPage is present. The final page alone carries adoptableSince — adopt
	// it only after EVERY listed nudge was accepted; on any partial failure
	// retain the prior watermark and restart the scan (duplicates, never loss).
	// An existing v1 since token starts a scan, carrying the watermark forward.
	// Never changes read state.
	TeamAttentionPage *TeamAttentionPageTeamAttentionPage `json:"teamAttentionPage"`
}

TeamAttentionPageResponse is returned by TeamAttentionPage on success.

func TeamAttentionPage added in v0.18.0 

func TeamAttentionPage(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	since *string,
	page *string,
) (data_ *TeamAttentionPageResponse, err_ error)

── #1384 bounded team attention ──────────────────────────────────────────── Drain every page before reporting a candidate since-token. Intermediate pages carry no adoptable token, so a router cannot accidentally skip unread work by accepting an incomplete scan. Bodies are never returned and the query never changes read state. The CLI never stores the final token: the router adopts it only after every listed nudge was accepted.

func (*TeamAttentionPageResponse) GetTeamAttentionPage added in v0.18.0 

func (v *TeamAttentionPageResponse) GetTeamAttentionPage() *TeamAttentionPageTeamAttentionPage

GetTeamAttentionPage returns TeamAttentionPageResponse.TeamAttentionPage, and is useful for accessing the field via an interface.

type TeamAttentionPageTeamAttentionPage added in v0.18.0 

type TeamAttentionPageTeamAttentionPage struct {
	// False while any Channel is unfinished or queued items remain undelivered.
	ScanComplete bool `json:"scanComplete"`
	// Continuation for the next pull; null on the final page.
	NextPage *string `json:"nextPage"`
	// FINAL PAGE ONLY: a since-watermark token (same shape v1 issued) to adopt
	// after every listed nudge was accepted. Never present while scanComplete
	// is false.
	AdoptableSince *string                                                         `json:"adoptableSince"`
	Items          []*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem `json:"items"`
}

TeamAttentionPageTeamAttentionPage includes the requested fields of the GraphQL type TeamAttentionPage.

func (*TeamAttentionPageTeamAttentionPage) GetAdoptableSince added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPage) GetAdoptableSince() *string

GetAdoptableSince returns TeamAttentionPageTeamAttentionPage.AdoptableSince, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPage) GetItems added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPage) GetItems() []*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem

GetItems returns TeamAttentionPageTeamAttentionPage.Items, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPage) GetNextPage added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPage) GetNextPage() *string

GetNextPage returns TeamAttentionPageTeamAttentionPage.NextPage, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPage) GetScanComplete added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPage) GetScanComplete() bool

GetScanComplete returns TeamAttentionPageTeamAttentionPage.ScanComplete, and is useful for accessing the field via an interface.

type TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem added in v0.18.0 

type TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem struct {
	Worker         string  `json:"worker"`
	WorkerName     string  `json:"workerName"`
	WorkerUrn      *string `json:"workerUrn"`
	Channel        string  `json:"channel"`
	ChannelName    string  `json:"channelName"`
	Unread         int     `json:"unread"`
	UnreadMentions int     `json:"unreadMentions"`
	FirstUnreadSeq *int    `json:"firstUnreadSeq"`
	// The frozen Channel head this item's counts are exact for.
	LastSeq int `json:"lastSeq"`
}

TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem includes the requested fields of the GraphQL type TeamAttentionPageItem. The GraphQL type's documentation follows.

#1384 paged (v2): one bounded slice of an attention scan. Counts are exact for the captured (seen, head] range of the issuing scan only, and items are emitted solely from Channels that scan has exhausted.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetChannel added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetChannel() string

GetChannel returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.Channel, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetChannelName added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetChannelName() string

GetChannelName returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.ChannelName, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetFirstUnreadSeq added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetFirstUnreadSeq() *int

GetFirstUnreadSeq returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.FirstUnreadSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetLastSeq added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetLastSeq() int

GetLastSeq returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.LastSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetUnread added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetUnread() int

GetUnread returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.Unread, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetUnreadMentions added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetUnreadMentions() int

GetUnreadMentions returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.UnreadMentions, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetWorker added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetWorker() string

GetWorker returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.Worker, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetWorkerName added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetWorkerName() string

GetWorkerName returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.WorkerName, and is useful for accessing the field via an interface.

func (*TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetWorkerUrn added in v0.18.0 

func (v *TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem) GetWorkerUrn() *string

GetWorkerUrn returns TeamAttentionPageTeamAttentionPageItemsTeamAttentionPageItem.WorkerUrn, and is useful for accessing the field via an interface.

type TeamAttentionPreviewPageResponse added in v0.18.0 

type TeamAttentionPreviewPageResponse struct {
	// #1384 paged switchover preview — same bounded scan as teamAttentionPage,
	// full-backlog accounting. The apply proof exists ONLY on the final page of
	// a completed preview; confirmTeamAttentionSwitchover (apply) is unchanged.
	TeamAttentionPreviewPage *TeamAttentionPreviewPageTeamAttentionPreviewPage `json:"teamAttentionPreviewPage"`
}

TeamAttentionPreviewPageResponse is returned by TeamAttentionPreviewPage on success.

func TeamAttentionPreviewPage added in v0.18.0 

func TeamAttentionPreviewPage(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	page *string,
) (data_ *TeamAttentionPreviewPageResponse, err_ error)

The read-only half of the one-time switchover, also bounded. Only the last page carries the short-lived proof; never expose a partial preview as apply-ready.

func (*TeamAttentionPreviewPageResponse) GetTeamAttentionPreviewPage added in v0.18.0 

func (v *TeamAttentionPreviewPageResponse) GetTeamAttentionPreviewPage() *TeamAttentionPreviewPageTeamAttentionPreviewPage

GetTeamAttentionPreviewPage returns TeamAttentionPreviewPageResponse.TeamAttentionPreviewPage, and is useful for accessing the field via an interface.

type TeamAttentionPreviewPageTeamAttentionPreviewPage added in v0.18.0 

type TeamAttentionPreviewPageTeamAttentionPreviewPage struct {
	ScanComplete bool    `json:"scanComplete"`
	NextPage     *string `json:"nextPage"`
	// FINAL PAGE ONLY: the short-lived switchover proof (frozen heads). An
	// incomplete preview never carries one, so a partial preview can never
	// silently discard an unscanned backlog.
	Proof     *string                                                                       `json:"proof"`
	ExpiresAt *string                                                                       `json:"expiresAt"`
	Items     []*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem `json:"items"`
}

TeamAttentionPreviewPageTeamAttentionPreviewPage includes the requested fields of the GraphQL type TeamAttentionPreviewPage.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPage) GetExpiresAt added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPage) GetExpiresAt() *string

GetExpiresAt returns TeamAttentionPreviewPageTeamAttentionPreviewPage.ExpiresAt, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPage) GetItems added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPage) GetItems() []*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem

GetItems returns TeamAttentionPreviewPageTeamAttentionPreviewPage.Items, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPage) GetNextPage added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPage) GetNextPage() *string

GetNextPage returns TeamAttentionPreviewPageTeamAttentionPreviewPage.NextPage, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPage) GetProof added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPage) GetProof() *string

GetProof returns TeamAttentionPreviewPageTeamAttentionPreviewPage.Proof, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPage) GetScanComplete added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPage) GetScanComplete() bool

GetScanComplete returns TeamAttentionPreviewPageTeamAttentionPreviewPage.ScanComplete, and is useful for accessing the field via an interface.

type TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem added in v0.18.0 

type TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem struct {
	Worker         string  `json:"worker"`
	WorkerName     string  `json:"workerName"`
	WorkerUrn      *string `json:"workerUrn"`
	Channel        string  `json:"channel"`
	ChannelName    string  `json:"channelName"`
	Unread         int     `json:"unread"`
	UnreadMentions int     `json:"unreadMentions"`
	FirstUnreadSeq *int    `json:"firstUnreadSeq"`
	// The frozen Channel head this item's counts are exact for.
	LastSeq int `json:"lastSeq"`
}

TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem includes the requested fields of the GraphQL type TeamAttentionPageItem. The GraphQL type's documentation follows.

#1384 paged (v2): one bounded slice of an attention scan. Counts are exact for the captured (seen, head] range of the issuing scan only, and items are emitted solely from Channels that scan has exhausted.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetChannel added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetChannel() string

GetChannel returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.Channel, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetChannelName added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetChannelName() string

GetChannelName returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.ChannelName, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetFirstUnreadSeq added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetFirstUnreadSeq() *int

GetFirstUnreadSeq returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.FirstUnreadSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetLastSeq added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetLastSeq() int

GetLastSeq returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.LastSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetUnread added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetUnread() int

GetUnread returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.Unread, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetUnreadMentions added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetUnreadMentions() int

GetUnreadMentions returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.UnreadMentions, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetWorker added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetWorker() string

GetWorker returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.Worker, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetWorkerName added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetWorkerName() string

GetWorkerName returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.WorkerName, and is useful for accessing the field via an interface.

func (*TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetWorkerUrn added in v0.18.0 

func (v *TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem) GetWorkerUrn() *string

GetWorkerUrn returns TeamAttentionPreviewPageTeamAttentionPreviewPageItemsTeamAttentionPageItem.WorkerUrn, and is useful for accessing the field via an interface.

type TeamAttentionResponse added in v0.18.0 

type TeamAttentionResponse struct {
	// #1353 v1 attention query, retired by #1384. This field always returns
	// UPGRADE_REQUIRED; use teamAttentionPage for bounded polling. Pass an
	// existing v1 since token to teamAttentionPage to carry its watermark
	// forward. Neither operation changes read state.
	TeamAttention *TeamAttentionTeamAttentionTeamAttentionResult `json:"teamAttention"`
}

TeamAttentionResponse is returned by TeamAttention on success.

func TeamAttention added in v0.18.0 

func TeamAttention(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	since *string,
) (data_ *TeamAttentionResponse, err_ error)

Compatibility with a server that has not deployed #1384 yet. The paged query is attempted first; this one is used only when its field is absent.

func (*TeamAttentionResponse) GetTeamAttention added in v0.18.0 

func (v *TeamAttentionResponse) GetTeamAttention() *TeamAttentionTeamAttentionTeamAttentionResult

GetTeamAttention returns TeamAttentionResponse.TeamAttention, and is useful for accessing the field via an interface.

type TeamAttentionSwitchoverPreviewResponse added in v0.18.0 

type TeamAttentionSwitchoverPreviewResponse struct {
	// Preview the explicit baseline switchover for the operator's current live
	// Workers. Read-only: inspect the exact cursors, heads and unread counts,
	// then pass proof to confirmTeamAttentionSwitchover within ten minutes.
	TeamAttentionSwitchoverPreview *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview `json:"teamAttentionSwitchoverPreview"`
}

TeamAttentionSwitchoverPreviewResponse is returned by TeamAttentionSwitchoverPreview on success.

func TeamAttentionSwitchoverPreview added in v0.18.0 

func TeamAttentionSwitchoverPreview(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
) (data_ *TeamAttentionSwitchoverPreviewResponse, err_ error)

The old read-only preview remains usable before #1384 is deployed.

func (*TeamAttentionSwitchoverPreviewResponse) GetTeamAttentionSwitchoverPreview added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewResponse) GetTeamAttentionSwitchoverPreview() *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview

GetTeamAttentionSwitchoverPreview returns TeamAttentionSwitchoverPreviewResponse.TeamAttentionSwitchoverPreview, and is useful for accessing the field via an interface.

type TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview added in v0.18.0 

type TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview struct {
	// Short-lived proof binding the exact operator, App, Workers, registers, cursors and heads shown here.
	Proof     string                                                                                              `json:"proof"`
	ExpiresAt string                                                                                              `json:"expiresAt"`
	Workers   []*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker `json:"workers"`
}

TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview includes the requested fields of the GraphQL type TeamAttentionSwitchoverPreview.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview) GetExpiresAt added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview) GetExpiresAt() string

GetExpiresAt returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview.ExpiresAt, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview) GetProof added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview) GetProof() string

GetProof returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview.Proof, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview) GetWorkers added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview) GetWorkers() []*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker

GetWorkers returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreview.Workers, and is useful for accessing the field via an interface.

type TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker added in v0.18.0 

type TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker struct {
	Worker   string                                                                                                                                    `json:"worker"`
	Name     string                                                                                                                                    `json:"name"`
	Urn      *string                                                                                                                                   `json:"urn"`
	Channels []*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel `json:"channels"`
}

TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker includes the requested fields of the GraphQL type TeamAttentionSwitchoverWorker.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetChannels added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetChannels() []*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel

GetChannels returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker.Channels, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetName added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetName() string

GetName returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker.Name, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetUrn added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetUrn() *string

GetUrn returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker.Urn, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetWorker added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker) GetWorker() string

GetWorker returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorker.Worker, and is useful for accessing the field via an interface.

type TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel added in v0.18.0 

type TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel struct {
	Channel        string `json:"channel"`
	Name           string `json:"name"`
	FromSeq        int    `json:"fromSeq"`
	ThroughSeq     int    `json:"throughSeq"`
	Unread         int    `json:"unread"`
	UnreadMentions int    `json:"unreadMentions"`
}

TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel includes the requested fields of the GraphQL type TeamAttentionSwitchoverChannel.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetChannel added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetChannel() string

GetChannel returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel.Channel, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetFromSeq added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetFromSeq() int

GetFromSeq returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel.FromSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetName added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetName() string

GetName returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel.Name, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetThroughSeq added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetThroughSeq() int

GetThroughSeq returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel.ThroughSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetUnread added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetUnread() int

GetUnread returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel.Unread, and is useful for accessing the field via an interface.

func (*TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetUnreadMentions added in v0.18.0 

func (v *TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel) GetUnreadMentions() int

GetUnreadMentions returns TeamAttentionSwitchoverPreviewTeamAttentionSwitchoverPreviewWorkersTeamAttentionSwitchoverWorkerChannelsTeamAttentionSwitchoverChannel.UnreadMentions, and is useful for accessing the field via an interface.

type TeamAttentionTeamAttentionTeamAttentionResult added in v0.18.0 

type TeamAttentionTeamAttentionTeamAttentionResult struct {
	// Opaque signed snapshot. Adopt it only after every listed nudge is accepted.
	Token   string                                                                     `json:"token"`
	Workers []*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker `json:"workers"`
}

TeamAttentionTeamAttentionTeamAttentionResult includes the requested fields of the GraphQL type TeamAttentionResult.

func (*TeamAttentionTeamAttentionTeamAttentionResult) GetToken added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResult) GetToken() string

GetToken returns TeamAttentionTeamAttentionTeamAttentionResult.Token, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResult) GetWorkers added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResult) GetWorkers() []*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker

GetWorkers returns TeamAttentionTeamAttentionTeamAttentionResult.Workers, and is useful for accessing the field via an interface.

type TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker added in v0.18.0 

type TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker struct {
	Worker   string                                                                                                 `json:"worker"`
	Name     string                                                                                                 `json:"name"`
	Urn      *string                                                                                                `json:"urn"`
	Live     bool                                                                                                   `json:"live"`
	Channels []*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel `json:"channels"`
}

TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker includes the requested fields of the GraphQL type TeamAttentionWorker. The GraphQL type's documentation follows.

#1353 — one live Worker that has relevant unread attention after the supplied token.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetChannels added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetChannels() []*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel

GetChannels returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker.Channels, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetLive added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetLive() bool

GetLive returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker.Live, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetName added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetName() string

GetName returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker.Name, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetUrn added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetUrn() *string

GetUrn returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker.Urn, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetWorker added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker) GetWorker() string

GetWorker returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorker.Worker, and is useful for accessing the field via an interface.

type TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel added in v0.18.0 

type TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel struct {
	Channel        string `json:"channel"`
	Name           string `json:"name"`
	Unread         int    `json:"unread"`
	UnreadMentions int    `json:"unreadMentions"`
	FirstUnreadSeq *int   `json:"firstUnreadSeq"`
	LastSeq        int    `json:"lastSeq"`
}

TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel includes the requested fields of the GraphQL type TeamAttentionChannel. The GraphQL type's documentation follows.

#1353 — compact unread metadata for one Worker/Channel pair. No message body is returned.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetChannel added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetChannel() string

GetChannel returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel.Channel, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetFirstUnreadSeq added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetFirstUnreadSeq() *int

GetFirstUnreadSeq returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel.FirstUnreadSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetLastSeq added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetLastSeq() int

GetLastSeq returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel.LastSeq, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetName added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetName() string

GetName returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel.Name, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetUnread added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetUnread() int

GetUnread returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel.Unread, and is useful for accessing the field via an interface.

func (*TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetUnreadMentions added in v0.18.0 

func (v *TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel) GetUnreadMentions() int

GetUnreadMentions returns TeamAttentionTeamAttentionTeamAttentionResultWorkersTeamAttentionWorkerChannelsTeamAttentionChannel.UnreadMentions, and is useful for accessing the field via an interface.

type TeamChatMessageFields added in v0.9.0 

type TeamChatMessageFields struct {
	// The message node's id.
	NodeId string `json:"nodeId"`
	// Ordering key, unique per chat, allocated atomically (ascending from 1).
	Seq            int     `json:"seq"`
	Body           string  `json:"body"`
	At             string  `json:"at"`
	AuthorUserId   *string `json:"authorUserId"`
	AuthorWorkerId *string `json:"authorWorkerId"`
	// Display convenience: the worker name or the user handle.
	AuthorName *string `json:"authorName"`
	// The session driving the worker author, when posted via sessionRef.
	SessionId *string `json:"sessionId"`
	// The seq this message replies to, when it is a reply.
	ReplyToSeq *int     `json:"replyToSeq"`
	Mentions   []string `json:"mentions"`
}

TeamChatMessageFields includes the GraphQL fields of TeamChatMessage requested by the fragment TeamChatMessageFields. The GraphQL type's documentation follows.

One message in a team App's chat (#939, Worker envelope since #974). Exactly one of authorUserId / authorWorkerId is set: a human post carries the user, a worker post carries the Worker (the named casting, cor:dmo:050:11) plus the driving sessionId. mentions holds the lowercased tokens extracted server-side at write time (the '@worker-name / @handle' format, stored without the '@').

func (*TeamChatMessageFields) GetAt added in v0.9.0 

func (v *TeamChatMessageFields) GetAt() string

GetAt returns TeamChatMessageFields.At, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetAuthorName added in v0.9.0 

func (v *TeamChatMessageFields) GetAuthorName() *string

GetAuthorName returns TeamChatMessageFields.AuthorName, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetAuthorUserId added in v0.9.0 

func (v *TeamChatMessageFields) GetAuthorUserId() *string

GetAuthorUserId returns TeamChatMessageFields.AuthorUserId, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetAuthorWorkerId added in v0.9.0 

func (v *TeamChatMessageFields) GetAuthorWorkerId() *string

GetAuthorWorkerId returns TeamChatMessageFields.AuthorWorkerId, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetBody added in v0.9.0 

func (v *TeamChatMessageFields) GetBody() string

GetBody returns TeamChatMessageFields.Body, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetMentions added in v0.9.0 

func (v *TeamChatMessageFields) GetMentions() []string

GetMentions returns TeamChatMessageFields.Mentions, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetNodeId added in v0.9.0 

func (v *TeamChatMessageFields) GetNodeId() string

GetNodeId returns TeamChatMessageFields.NodeId, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetReplyToSeq added in v0.9.0 

func (v *TeamChatMessageFields) GetReplyToSeq() *int

GetReplyToSeq returns TeamChatMessageFields.ReplyToSeq, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetSeq added in v0.9.0 

func (v *TeamChatMessageFields) GetSeq() int

GetSeq returns TeamChatMessageFields.Seq, and is useful for accessing the field via an interface.

func (*TeamChatMessageFields) GetSessionId added in v0.9.0 

func (v *TeamChatMessageFields) GetSessionId() *string

GetSessionId returns TeamChatMessageFields.SessionId, and is useful for accessing the field via an interface.

type TeamChatMessagesResponse added in v0.9.0 

type TeamChatMessagesResponse struct {
	// Read a team App's chat (#939), seq-ordered ascending, as a uniform
	// { items, total } page. sinceSeq is a watermark cursor: only messages with
	// seq STRICTLY GREATER than it are returned (pass the last seq you have
	// seen). With neither cursor nor offset, the NEWEST page is returned, still
	// ascending. Pass sinceSeq: 0 to start a forward walk at the oldest message.
	// beforeSeq (#1116) is its BACKWARD mirror for scroll-up paging: only
	// messages with seq STRICTLY LESS than it are considered, and the NEWEST
	// limit of those come back -- the page immediately before the cursor, still
	// ascending. The two compose, so passing both reads a bounded slice.
	// TeamChatMessagesPage.total counts that cursor range and the mentionsRef
	// filter before paging, not the whole team-chat history.
	// An explicit offset retains oldest-first positional paging for existing
	// clients; prefer cursors for new reads. offset is IGNORED when beforeSeq is
	// given: a cursor exists precisely because a position is unstable while
	// workers keep posting, and honouring both would put that race back.
	// mentionsRef filters to messages whose stored envelope mentions the
	// referenced worker (a Worker id or name of THIS App, retired included) or
	// user (handle/id) — matching runs against the mention tokens extracted at
	// write time, never by re-parsing bodies. The ref must name this App's own
	// staff or members (a Worker of the App, an AppMember, or the caller); an
	// unresolvable or foreign mentionsRef yields the empty page identically (no
	// existence oracle). limit defaults to 50 (cap 200); limit: 0 returns only
	// total.
	//
	// Authorization: an AppMember of the App (any role), an org member with
	// CONTRIBUTOR+ on the App's org, the owner of a user-owned App, or the
	// App's own key (a pure App-key principal may READ its team chat).
	// Error codes (extensions.code): FORBIDDEN (an authenticated caller who is
	// not a participant), UNAUTHENTICATED (no principal at all; checked before
	// the App is resolved, so it answers identically whether or not the App
	// exists).
	//
	// appRef and mentionsRef accept the entity's ID or URN.
	TeamChatMessages *TeamChatMessagesTeamChatMessagesTeamChatMessagesPage `json:"teamChatMessages"`
}

TeamChatMessagesResponse is returned by TeamChatMessages on success.

func TeamChatMessages added in v0.9.0 

func TeamChatMessages(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	sinceSeq *int,
	mentionsRef *string,
	limit *int,
	offset *int,
	beforeSeq *int,
) (data_ *TeamChatMessagesResponse, err_ error)

func (*TeamChatMessagesResponse) GetTeamChatMessages added in v0.9.0 

func (v *TeamChatMessagesResponse) GetTeamChatMessages() *TeamChatMessagesTeamChatMessagesTeamChatMessagesPage

GetTeamChatMessages returns TeamChatMessagesResponse.TeamChatMessages, and is useful for accessing the field via an interface.

type TeamChatMessagesTeamChatMessagesTeamChatMessagesPage added in v0.9.0 

type TeamChatMessagesTeamChatMessagesTeamChatMessagesPage struct {
	// Number of canonical messages matching this read's sinceSeq/beforeSeq cursor
	// range and mentionsRef filter, before limit/offset. It is not the total
	// number of messages in the chat or Channel when a cursor/filter is present.
	Total int                                                                         `json:"total"`
	Items []*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage `json:"items"`
}

TeamChatMessagesTeamChatMessagesTeamChatMessagesPage includes the requested fields of the GraphQL type TeamChatMessagesPage.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPage) GetItems added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPage) GetItems() []*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage

GetItems returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPage.Items, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPage) GetTotal added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPage) GetTotal() int

GetTotal returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPage.Total, and is useful for accessing the field via an interface.

type TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage added in v0.9.0 

type TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage struct {
	TeamChatMessageFields `json:"-"`
}

TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage includes the requested fields of the GraphQL type TeamChatMessage. The GraphQL type's documentation follows.

One message in a team App's chat (#939, Worker envelope since #974). Exactly one of authorUserId / authorWorkerId is set: a human post carries the user, a worker post carries the Worker (the named casting, cor:dmo:050:11) plus the driving sessionId. mentions holds the lowercased tokens extracted server-side at write time (the '@worker-name / @handle' format, stored without the '@').

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAt added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAt() string

GetAt returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.At, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorName added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorName() *string

GetAuthorName returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.AuthorName, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorUserId added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorUserId() *string

GetAuthorUserId returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.AuthorUserId, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorWorkerId added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetAuthorWorkerId() *string

GetAuthorWorkerId returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.AuthorWorkerId, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetBody added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetBody() string

GetBody returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.Body, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetMentions added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetMentions() []string

GetMentions returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.Mentions, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetNodeId added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetNodeId() string

GetNodeId returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.NodeId, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetReplyToSeq added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetReplyToSeq() *int

GetReplyToSeq returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.ReplyToSeq, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSeq added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSeq() int

GetSeq returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.Seq, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSessionId added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) GetSessionId() *string

GetSessionId returns TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage.SessionId, and is useful for accessing the field via an interface.

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) MarshalJSON added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) MarshalJSON() ([]byte, error)

func (*TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) UnmarshalJSON added in v0.9.0 

func (v *TeamChatMessagesTeamChatMessagesTeamChatMessagesPageItemsTeamChatMessage) UnmarshalJSON(b []byte) error

type TeamDefaultChannelApp added in v0.18.0 

type TeamDefaultChannelApp struct {
	Id string `json:"id"`
	// Spec 049 Phase 4: the App's default Channel — the row its team chat became (null until provisioned).
	DefaultChannel *TeamDefaultChannelAppDefaultChannel `json:"defaultChannel"`
}

TeamDefaultChannelApp includes the requested fields of the GraphQL type App. The GraphQL type's documentation follows.

A runtime caller identity owned by exactly one Organization or User. It owns long-lived App Keys and installs Agents through the AppAgent N:M join: one App may install many Agents, and one Agent may be installed in many Apps. The singular agentId / agent fields below are soft-deprecated convenience reads of the first install, not a direct foreign key.

func (*TeamDefaultChannelApp) GetDefaultChannel added in v0.18.0 

func (v *TeamDefaultChannelApp) GetDefaultChannel() *TeamDefaultChannelAppDefaultChannel

GetDefaultChannel returns TeamDefaultChannelApp.DefaultChannel, and is useful for accessing the field via an interface.

func (*TeamDefaultChannelApp) GetId added in v0.18.0 

func (v *TeamDefaultChannelApp) GetId() string

GetId returns TeamDefaultChannelApp.Id, and is useful for accessing the field via an interface.

type TeamDefaultChannelAppDefaultChannel added in v0.18.0 

type TeamDefaultChannelAppDefaultChannel struct {
	Id string `json:"id"`
}

TeamDefaultChannelAppDefaultChannel includes the requested fields of the GraphQL type Channel. The GraphQL type's documentation follows.

A CHANNEL (spec 049, D-2026-09-13-006): a durable, ordered message stream hosted in ONE memory at ONE reserved address, server-ordered and server-attributed — a platform entity, created one-to-one with its chat root. Creating it RESERVES and PROTECTS the address: generic node writes under it are refused (LOC_PROTECTED); its own operations (createTeamChatMessage, hadron_team_chat_post) are the only writers. The audience is the host memory's (cor:acl:030:01) — a Channel has no access layer of its own. `lastSeq` / `lastMessageAt` are the platform-maintained watermark.

func (*TeamDefaultChannelAppDefaultChannel) GetId added in v0.18.0 

func (v *TeamDefaultChannelAppDefaultChannel) GetId() string

GetId returns TeamDefaultChannelAppDefaultChannel.Id, and is useful for accessing the field via an interface.

type TeamDefaultChannelResponse added in v0.18.0 

type TeamDefaultChannelResponse struct {
	// Fetch an App (member of the App's org, or platform ADMIN — the myApps
	// exposure bar; #473 relaxed this from org ADMIN for read parity with the
	// list).
	//
	// 'ref' accepts the entity's ID or URN.
	App *TeamDefaultChannelApp `json:"app"`
}

TeamDefaultChannelResponse is returned by TeamDefaultChannel on success.

func TeamDefaultChannel added in v0.18.0 

func TeamDefaultChannel(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
) (data_ *TeamDefaultChannelResponse, err_ error)

The App's default team Channel — what `team chat mark-read` advances when no --channel is given, matching hadron_team_chat_mark_read's default.

func (*TeamDefaultChannelResponse) GetApp added in v0.18.0 

func (v *TeamDefaultChannelResponse) GetApp() *TeamDefaultChannelApp

GetApp returns TeamDefaultChannelResponse.App, and is useful for accessing the field via an interface.

type TeamMemoryAppMemory added in v0.9.0 

type TeamMemoryAppMemory struct {
	Id string `json:"id"`
	// The App this memory is scoped to. REQUIRED for `class='app'`,
	// FORBIDDEN for `class='system'` (an agent's own definition is never
	// App-scoped), and OPTIONAL for `knowledge` / `group` / `personal` /
	// `private` — set when provisioned inside an App, NULL when the memory
	// is free-standing. Enforced by `chk_memory_class_app_id`. (034 relaxed
	// the personal case and #653 moved knowledge + group from forbidden to
	// optional; this said "required for app/personal, NULL otherwise" until
	// #1232.)
	AppId *string `json:"appId"`
}

TeamMemoryAppMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*TeamMemoryAppMemory) GetAppId added in v0.9.0 

func (v *TeamMemoryAppMemory) GetAppId() *string

GetAppId returns TeamMemoryAppMemory.AppId, and is useful for accessing the field via an interface.

func (*TeamMemoryAppMemory) GetId added in v0.9.0 

func (v *TeamMemoryAppMemory) GetId() string

GetId returns TeamMemoryAppMemory.Id, and is useful for accessing the field via an interface.

type TeamMemoryAppResponse added in v0.9.0 

type TeamMemoryAppResponse struct {
	// Fetch a single Memory (org member, shared-read gate, or platform ADMIN).
	// Missing and unreadable refs both return null without an error, so a caller
	// cannot use this field to test whether a private memory exists. Malformed
	// refs still fail as caller errors, and operational faults still propagate.
	//
	// 'ref' accepts the entity's ID or URN.
	Memory *TeamMemoryAppMemory `json:"memory"`
}

TeamMemoryAppResponse is returned by TeamMemoryApp on success.

func TeamMemoryApp added in v0.9.0 

func TeamMemoryApp(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
) (data_ *TeamMemoryAppResponse, err_ error)

The binding records the team MEMORY (`session start -m`), while the chat operations address the APP — this resolves one to the other (the team memory is the App's shared app-class memory, so its appId IS the team App).

func (*TeamMemoryAppResponse) GetMemory added in v0.9.0 

func (v *TeamMemoryAppResponse) GetMemory() *TeamMemoryAppMemory

GetMemory returns TeamMemoryAppResponse.Memory, and is useful for accessing the field via an interface.

type TeamRoleFields added in v0.9.0 

type TeamRoleFields struct {
	// The role slug, e.g. backend-engineer.
	Role string `json:"role"`
	// The node loc: roles:<role>.
	Loc         string  `json:"loc"`
	NodeId      string  `json:"nodeId"`
	Description *string `json:"description"`
	// The single installed agent whose personaRole matches this role — exactly
	// the agent a role-mode castWorker would use (null when zero or ambiguous).
	// Runs Query.agent's own read gate and masks to null on deny (the #552
	// posture), like Worker.agent.
	RoleAgent *TeamRoleFieldsRoleAgent `json:"roleAgent"`
	// Whether the role-agent's systemPrompt binds {{name}} — the check that
	// finds templates which silently produce nameless workers (role-agents
	// authored before any guard existed). Null when no single role-agent
	// resolves. Computed even when roleAgent itself is masked: it discloses one
	// boolean about the caller's own App's casting default.
	HasNamePlaceholder *bool `json:"hasNamePlaceholder"`
}

── Role definitions (#403 / hadron-server#960) — the pre-cast read.

The register projection this fragment was built around (register / freeCount / exhausted / nameRange / nameConvention) is GONE — hadron-server#1050 removed the worker name register outright, and cor:agt:020:07 is withdrawn rather than superseded. What remains is the role's identity, its description, and the agent a role-mode cast would resolve.

func (*TeamRoleFields) GetDescription added in v0.9.0 

func (v *TeamRoleFields) GetDescription() *string

GetDescription returns TeamRoleFields.Description, and is useful for accessing the field via an interface.

func (*TeamRoleFields) GetHasNamePlaceholder added in v0.9.0 

func (v *TeamRoleFields) GetHasNamePlaceholder() *bool

GetHasNamePlaceholder returns TeamRoleFields.HasNamePlaceholder, and is useful for accessing the field via an interface.

func (*TeamRoleFields) GetLoc added in v0.9.0 

func (v *TeamRoleFields) GetLoc() string

GetLoc returns TeamRoleFields.Loc, and is useful for accessing the field via an interface.

func (*TeamRoleFields) GetNodeId added in v0.9.0 

func (v *TeamRoleFields) GetNodeId() string

GetNodeId returns TeamRoleFields.NodeId, and is useful for accessing the field via an interface.

func (*TeamRoleFields) GetRole added in v0.9.0 

func (v *TeamRoleFields) GetRole() string

GetRole returns TeamRoleFields.Role, and is useful for accessing the field via an interface.

func (*TeamRoleFields) GetRoleAgent added in v0.9.0 

func (v *TeamRoleFields) GetRoleAgent() *TeamRoleFieldsRoleAgent

GetRoleAgent returns TeamRoleFields.RoleAgent, and is useful for accessing the field via an interface.

type TeamRoleFieldsRoleAgent added in v0.9.0 

type TeamRoleFieldsRoleAgent struct {
	Id   string `json:"id"`
	Urn  string `json:"urn"`
	Name string `json:"name"`
	// Persona role - free string with conventions ('backend-engineer').
	PersonaRole *string `json:"personaRole"`
}

TeamRoleFieldsRoleAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*TeamRoleFieldsRoleAgent) GetId added in v0.9.0 

func (v *TeamRoleFieldsRoleAgent) GetId() string

GetId returns TeamRoleFieldsRoleAgent.Id, and is useful for accessing the field via an interface.

func (*TeamRoleFieldsRoleAgent) GetName added in v0.9.0 

func (v *TeamRoleFieldsRoleAgent) GetName() string

GetName returns TeamRoleFieldsRoleAgent.Name, and is useful for accessing the field via an interface.

func (*TeamRoleFieldsRoleAgent) GetPersonaRole added in v0.9.0 

func (v *TeamRoleFieldsRoleAgent) GetPersonaRole() *string

GetPersonaRole returns TeamRoleFieldsRoleAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*TeamRoleFieldsRoleAgent) GetUrn added in v0.9.0 

func (v *TeamRoleFieldsRoleAgent) GetUrn() string

GetUrn returns TeamRoleFieldsRoleAgent.Urn, and is useful for accessing the field via an interface.

type TeamRolesResponse added in v0.9.0 

type TeamRolesResponse struct {
	// An App's role definitions (#960): every roles:<role> node in the Team
	// Agent's system memory. Ordered by role slug. Same read authorization as
	// workers.
	//
	// #1050: no register projection. This once existed chiefly to answer "which
	// names are still free", which needed the App's FULL roster and so could not
	// be computed client-side — with names no longer allocated from a pool there
	// is no such question, and the read is a plain list of definitions. teamAgentRef disambiguates when more than one installed agent
	// carries a roles: branch (TEAM_AGENT_AMBIGUOUS otherwise); an encrypted
	// system memory without an active session key refuses SESSION_EXPIRED.
	TeamRoles *TeamRolesTeamRolesTeamRolesPage `json:"teamRoles"`
}

TeamRolesResponse is returned by TeamRoles on success.

func TeamRoles added in v0.9.0 

func TeamRoles(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	teamAgentRef *string,
	limit *int,
	offset *int,
) (data_ *TeamRolesResponse, err_ error)

func (*TeamRolesResponse) GetTeamRoles added in v0.9.0 

func (v *TeamRolesResponse) GetTeamRoles() *TeamRolesTeamRolesTeamRolesPage

GetTeamRoles returns TeamRolesResponse.TeamRoles, and is useful for accessing the field via an interface.

type TeamRolesTeamRolesTeamRolesPage added in v0.9.0 

type TeamRolesTeamRolesTeamRolesPage struct {
	Total int                                             `json:"total"`
	Items []*TeamRolesTeamRolesTeamRolesPageItemsTeamRole `json:"items"`
}

TeamRolesTeamRolesTeamRolesPage includes the requested fields of the GraphQL type TeamRolesPage.

func (*TeamRolesTeamRolesTeamRolesPage) GetItems added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPage) GetItems() []*TeamRolesTeamRolesTeamRolesPageItemsTeamRole

GetItems returns TeamRolesTeamRolesTeamRolesPage.Items, and is useful for accessing the field via an interface.

func (*TeamRolesTeamRolesTeamRolesPage) GetTotal added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPage) GetTotal() int

GetTotal returns TeamRolesTeamRolesTeamRolesPage.Total, and is useful for accessing the field via an interface.

type TeamRolesTeamRolesTeamRolesPageItemsTeamRole added in v0.9.0 

type TeamRolesTeamRolesTeamRolesPageItemsTeamRole struct {
	TeamRoleFields `json:"-"`
}

TeamRolesTeamRolesTeamRolesPageItemsTeamRole includes the requested fields of the GraphQL type TeamRole. The GraphQL type's documentation follows.

A role definition (#960): the roles:<role> node in the Team Agent's system memory. #1050: it carries no name register — a role is a definition, not an allocation pool. The prompt template is NOT here — with the Worker model (#974) it lives on the role-agent (personaRole + systemPrompt); roleAgent points at it.

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetDescription added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetDescription() *string

GetDescription returns TeamRolesTeamRolesTeamRolesPageItemsTeamRole.Description, and is useful for accessing the field via an interface.

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetHasNamePlaceholder added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetHasNamePlaceholder() *bool

GetHasNamePlaceholder returns TeamRolesTeamRolesTeamRolesPageItemsTeamRole.HasNamePlaceholder, and is useful for accessing the field via an interface.

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetLoc added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetLoc() string

GetLoc returns TeamRolesTeamRolesTeamRolesPageItemsTeamRole.Loc, and is useful for accessing the field via an interface.

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetNodeId added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetNodeId() string

GetNodeId returns TeamRolesTeamRolesTeamRolesPageItemsTeamRole.NodeId, and is useful for accessing the field via an interface.

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetRole added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetRole() string

GetRole returns TeamRolesTeamRolesTeamRolesPageItemsTeamRole.Role, and is useful for accessing the field via an interface.

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetRoleAgent added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) GetRoleAgent() *TeamRoleFieldsRoleAgent

GetRoleAgent returns TeamRolesTeamRolesTeamRolesPageItemsTeamRole.RoleAgent, and is useful for accessing the field via an interface.

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) MarshalJSON added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) MarshalJSON() ([]byte, error)

func (*TeamRolesTeamRolesTeamRolesPageItemsTeamRole) UnmarshalJSON added in v0.9.0 

func (v *TeamRolesTeamRolesTeamRolesPageItemsTeamRole) UnmarshalJSON(b []byte) error

type TeamSessionFields added in v0.9.0 

type TeamSessionFields struct {
	Id string `json:"id"`
	// The role-agent driving the session (with workerId set, the agent behind the casting).
	AgentId *string `json:"agentId"`
	// #974 / cor:agt:020:03: the Worker (named casting) this session works as.
	WorkerId *string `json:"workerId"`
	// #980 / cor:agt:020:02: the Worker behind workerId, nested — so a session
	// list can render the app-qualified compound ('eng-team/Iris') without a
	// per-row worker(ref:) + app(ref:) round trip (Worker carries name and app).
	// Resolves for RETIRED workers too: retirement ends the casting, not the
	// history, so past sessions stay attributable. Worker.app and Worker.agent
	// run their OWN read gates and mask to null on deny (#552), so this nesting
	// never widens what the session read admits.
	Worker *TeamSessionFieldsWorker `json:"worker"`
	UserId *string                  `json:"userId"`
	// Which kind of session this is: DEVELOPER, CHATBOT, AUTOMATION or EDGE.
	Type          string  `json:"type"`
	Repo          *string `json:"repo"`
	Branch        *string `json:"branch"`
	PrNumber      *int    `json:"prNumber"`
	StartedAt     string  `json:"startedAt"`
	EndedAt       *string `json:"endedAt"`
	AutoExpiredAt *string `json:"autoExpiredAt"`
	// #928: machine identifier the session ran on.
	Host *string `json:"host"`
	// #928: the tool driving the session ('claude-code', 'codex', ...).
	Tool *string `json:"tool"`
	// #928: where the driving tool's transcript lives on 'host'.
	TranscriptPath *string `json:"transcriptPath"`
	LlmModel       *string `json:"llmModel"`
}

TeamSessionFields includes the GraphQL fields of Session requested by the fragment TeamSessionFields. The GraphQL type's documentation follows.

A unit of work recorded against a user or App: the general row, and what the bare word "session" means throughout this schema (#1034). `type` says which kind — DEVELOPER, CHATBOT, AUTOMATION, EDGE — and `workerId` is optional.

A **worker session** is the subtype with `workerId` set: a Worker (named casting) bound to a driver, which is what makes work attributable to a teammate and what a merged PR traces back through. Binding is optional, so a list of these is not a staff view and may hold no worker sessions at all — read `workerId` per row rather than assuming either way.

A **chat session** is NOT one of these and has no row here: it is the conversation a human is in — the Claude Desktop window, the Claude Code session, the IDE chat. The two are independent and **ending one does not end the other**: a chat session that closes leaves its worker session open until endSession. Since #1114 nothing ends it for inactivity — silence is not evidence of abandonment — but it stops reading as LIVE once nobody has driven it inside its idle window, so the stale session stops blocking another bind without being ended or losing its unwritten handoff. That changes no HOLD: a human-held name stays held until explicit release, so only its holder can bind it again. Do not use "chat session" for a Chat (the agent conversation entity) — that is an **agent chat**, a third concept.

func (*TeamSessionFields) GetAgentId added in v0.9.0 

func (v *TeamSessionFields) GetAgentId() *string

GetAgentId returns TeamSessionFields.AgentId, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetAutoExpiredAt added in v0.15.0 

func (v *TeamSessionFields) GetAutoExpiredAt() *string

GetAutoExpiredAt returns TeamSessionFields.AutoExpiredAt, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetBranch added in v0.9.0 

func (v *TeamSessionFields) GetBranch() *string

GetBranch returns TeamSessionFields.Branch, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetEndedAt added in v0.9.0 

func (v *TeamSessionFields) GetEndedAt() *string

GetEndedAt returns TeamSessionFields.EndedAt, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetHost added in v0.9.0 

func (v *TeamSessionFields) GetHost() *string

GetHost returns TeamSessionFields.Host, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetId added in v0.9.0 

func (v *TeamSessionFields) GetId() string

GetId returns TeamSessionFields.Id, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetLlmModel added in v0.9.0 

func (v *TeamSessionFields) GetLlmModel() *string

GetLlmModel returns TeamSessionFields.LlmModel, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetPrNumber added in v0.9.0 

func (v *TeamSessionFields) GetPrNumber() *int

GetPrNumber returns TeamSessionFields.PrNumber, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetRepo added in v0.9.0 

func (v *TeamSessionFields) GetRepo() *string

GetRepo returns TeamSessionFields.Repo, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetStartedAt added in v0.9.0 

func (v *TeamSessionFields) GetStartedAt() string

GetStartedAt returns TeamSessionFields.StartedAt, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetTool added in v0.9.0 

func (v *TeamSessionFields) GetTool() *string

GetTool returns TeamSessionFields.Tool, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetTranscriptPath added in v0.9.0 

func (v *TeamSessionFields) GetTranscriptPath() *string

GetTranscriptPath returns TeamSessionFields.TranscriptPath, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetType added in v0.9.0 

func (v *TeamSessionFields) GetType() string

GetType returns TeamSessionFields.Type, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetUserId added in v0.9.0 

func (v *TeamSessionFields) GetUserId() *string

GetUserId returns TeamSessionFields.UserId, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetWorker added in v0.9.0 

func (v *TeamSessionFields) GetWorker() *TeamSessionFieldsWorker

GetWorker returns TeamSessionFields.Worker, and is useful for accessing the field via an interface.

func (*TeamSessionFields) GetWorkerId added in v0.9.0 

func (v *TeamSessionFields) GetWorkerId() *string

GetWorkerId returns TeamSessionFields.WorkerId, and is useful for accessing the field via an interface.

type TeamSessionFieldsWorker added in v0.9.0 

type TeamSessionFieldsWorker struct {
	Id string `json:"id"`
	// The worker's name ('Iris') — the identity every surface renders.
	Name string `json:"name"`
	// The cast-list role this filling answers ('backend-engineer').
	Role *string `json:"role"`
}

TeamSessionFieldsWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*TeamSessionFieldsWorker) GetId added in v0.9.0 

func (v *TeamSessionFieldsWorker) GetId() string

GetId returns TeamSessionFieldsWorker.Id, and is useful for accessing the field via an interface.

func (*TeamSessionFieldsWorker) GetName added in v0.9.0 

func (v *TeamSessionFieldsWorker) GetName() string

GetName returns TeamSessionFieldsWorker.Name, and is useful for accessing the field via an interface.

func (*TeamSessionFieldsWorker) GetRole added in v0.9.0 

func (v *TeamSessionFieldsWorker) GetRole() *string

GetRole returns TeamSessionFieldsWorker.Role, and is useful for accessing the field via an interface.

type TeamSessionsResponse added in v0.9.0 

type TeamSessionsResponse struct {
	// Sessions VISIBLE to the caller, newest first — not only the caller's own.
	// The scope is authorization-derived (`sessionScopeFilter`): a platform
	// ADMIN/OWNER sees every session, an App key sees its own App's, and an
	// ordinary user sees those of Apps in any org they belong to **plus** every
	// session attributed to them (the self branch is identity-scoped, so it does
	// not apply through impersonation). So a client must not present these as "my
	// activity" — many rows may be attributed to other users or Apps.
	//
	// Unfiltered, this is also the GENERAL row of every `type`, worker-bound or
	// not (#1034), so it is equally not a list of worker sessions.
	//
	// workerRef (#974): only sessions bound to that Worker (by id), newest first
	// - the 'taken right now' / 'last driven by' read (cor:agt:020:03). That
	// filter is what narrows this to worker sessions.
	Sessions []*TeamSessionsSessionsSession `json:"sessions"`
}

TeamSessionsResponse is returned by TeamSessions on success.

func TeamSessions added in v0.9.0 

func TeamSessions(
	ctx_ context.Context,
	client_ graphql.Client,
	repo *string,
	workerRef *string,
	limit *int,
	offset *int,
) (data_ *TeamSessionsResponse, err_ error)

workerRef (#974) is the server-side narrowing the taken/last-driven-by check reads: only sessions bound to that Worker (by id), newest first — so the presence check no longer scans the whole list. The plain listing still pages to exhaustion for --active (no active filter server-side).

func (*TeamSessionsResponse) GetSessions added in v0.9.0 

func (v *TeamSessionsResponse) GetSessions() []*TeamSessionsSessionsSession

GetSessions returns TeamSessionsResponse.Sessions, and is useful for accessing the field via an interface.

type TeamSessionsSessionsSession added in v0.9.0 

type TeamSessionsSessionsSession struct {
	TeamSessionFields `json:"-"`
}

TeamSessionsSessionsSession includes the requested fields of the GraphQL type Session. The GraphQL type's documentation follows.

A unit of work recorded against a user or App: the general row, and what the bare word "session" means throughout this schema (#1034). `type` says which kind — DEVELOPER, CHATBOT, AUTOMATION, EDGE — and `workerId` is optional.

A **worker session** is the subtype with `workerId` set: a Worker (named casting) bound to a driver, which is what makes work attributable to a teammate and what a merged PR traces back through. Binding is optional, so a list of these is not a staff view and may hold no worker sessions at all — read `workerId` per row rather than assuming either way.

A **chat session** is NOT one of these and has no row here: it is the conversation a human is in — the Claude Desktop window, the Claude Code session, the IDE chat. The two are independent and **ending one does not end the other**: a chat session that closes leaves its worker session open until endSession. Since #1114 nothing ends it for inactivity — silence is not evidence of abandonment — but it stops reading as LIVE once nobody has driven it inside its idle window, so the stale session stops blocking another bind without being ended or losing its unwritten handoff. That changes no HOLD: a human-held name stays held until explicit release, so only its holder can bind it again. Do not use "chat session" for a Chat (the agent conversation entity) — that is an **agent chat**, a third concept.

func (*TeamSessionsSessionsSession) GetAgentId added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetAgentId() *string

GetAgentId returns TeamSessionsSessionsSession.AgentId, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetAutoExpiredAt added in v0.15.0 

func (v *TeamSessionsSessionsSession) GetAutoExpiredAt() *string

GetAutoExpiredAt returns TeamSessionsSessionsSession.AutoExpiredAt, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetBranch added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetBranch() *string

GetBranch returns TeamSessionsSessionsSession.Branch, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetEndedAt added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetEndedAt() *string

GetEndedAt returns TeamSessionsSessionsSession.EndedAt, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetHost added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetHost() *string

GetHost returns TeamSessionsSessionsSession.Host, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetId added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetId() string

GetId returns TeamSessionsSessionsSession.Id, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetLlmModel added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetLlmModel() *string

GetLlmModel returns TeamSessionsSessionsSession.LlmModel, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetPrNumber added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetPrNumber() *int

GetPrNumber returns TeamSessionsSessionsSession.PrNumber, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetRepo added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetRepo() *string

GetRepo returns TeamSessionsSessionsSession.Repo, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetStartedAt added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetStartedAt() string

GetStartedAt returns TeamSessionsSessionsSession.StartedAt, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetTool added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetTool() *string

GetTool returns TeamSessionsSessionsSession.Tool, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetTranscriptPath added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetTranscriptPath() *string

GetTranscriptPath returns TeamSessionsSessionsSession.TranscriptPath, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetType added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetType() string

GetType returns TeamSessionsSessionsSession.Type, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetUserId added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetUserId() *string

GetUserId returns TeamSessionsSessionsSession.UserId, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetWorker added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetWorker() *TeamSessionFieldsWorker

GetWorker returns TeamSessionsSessionsSession.Worker, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) GetWorkerId added in v0.9.0 

func (v *TeamSessionsSessionsSession) GetWorkerId() *string

GetWorkerId returns TeamSessionsSessionsSession.WorkerId, and is useful for accessing the field via an interface.

func (*TeamSessionsSessionsSession) MarshalJSON added in v0.9.0 

func (v *TeamSessionsSessionsSession) MarshalJSON() ([]byte, error)

func (*TeamSessionsSessionsSession) UnmarshalJSON added in v0.9.0 

func (v *TeamSessionsSessionsSession) UnmarshalJSON(b []byte) error

type TeamWorkItemFields added in v0.9.0 

type TeamWorkItemFields struct {
	// The record node's id.
	NodeId string `json:"nodeId"`
	// The session the work is attributed to.
	SessionId string `json:"sessionId"`
	// The Worker (named casting) behind the record, when the session was worker-bound.
	WorkerId *string `json:"workerId"`
	// Display convenience, denormalized at write: the session's bound worker name, else the attributed user's handle (pre-#974 records surface their stored personaName here).
	WorkerName string `json:"workerName"`
	// The external tool the artifact lives in ('github', ...). Lowercased.
	Tool string `json:"tool"`
	// Artifact kind: pr, issue, commit, branch, or repo.
	Kind string `json:"kind"`
	// The canonical artifact ref — the equality-lookup key.
	Ref string `json:"ref"`
	// What happened: opened, merged, claimed, reviewed, closed, pushed, ... (free string, lowercased).
	Action string `json:"action"`
	// When the record was made (server-stamped).
	At string `json:"at"`
	// Optional display extras (title, URL) — never filtered on.
	Detail *json.RawMessage `json:"detail"`
	// The LLM model that produced the work, snapshotted at record time (#1398): an explicit report wins over the recording session's model; null on records that predate the field or were made with none — never backfilled, so null always means unknown-at-record-time.
	Model *string `json:"model"`
}

── Worklog (#947) — the dedicated operations. The CLI previously composed worklog records itself and wrote them through the generic object surface, which put the record shape in two places; the server owns it (hadron-cli#396). Since #974 the record attributes through the Worker: workerName is the denormalized display name (pre-#974 rows surface their stored personaName here), workerId the casting behind it when the session was worker-bound.

func (*TeamWorkItemFields) GetAction added in v0.9.0 

func (v *TeamWorkItemFields) GetAction() string

GetAction returns TeamWorkItemFields.Action, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetAt added in v0.9.0 

func (v *TeamWorkItemFields) GetAt() string

GetAt returns TeamWorkItemFields.At, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetDetail added in v0.9.0 

func (v *TeamWorkItemFields) GetDetail() *json.RawMessage

GetDetail returns TeamWorkItemFields.Detail, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetKind added in v0.9.0 

func (v *TeamWorkItemFields) GetKind() string

GetKind returns TeamWorkItemFields.Kind, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetModel added in v0.18.0 

func (v *TeamWorkItemFields) GetModel() *string

GetModel returns TeamWorkItemFields.Model, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetNodeId added in v0.9.0 

func (v *TeamWorkItemFields) GetNodeId() string

GetNodeId returns TeamWorkItemFields.NodeId, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetRef added in v0.9.0 

func (v *TeamWorkItemFields) GetRef() string

GetRef returns TeamWorkItemFields.Ref, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetSessionId added in v0.9.0 

func (v *TeamWorkItemFields) GetSessionId() string

GetSessionId returns TeamWorkItemFields.SessionId, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetTool added in v0.9.0 

func (v *TeamWorkItemFields) GetTool() string

GetTool returns TeamWorkItemFields.Tool, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetWorkerId added in v0.9.0 

func (v *TeamWorkItemFields) GetWorkerId() *string

GetWorkerId returns TeamWorkItemFields.WorkerId, and is useful for accessing the field via an interface.

func (*TeamWorkItemFields) GetWorkerName added in v0.9.0 

func (v *TeamWorkItemFields) GetWorkerName() string

GetWorkerName returns TeamWorkItemFields.WorkerName, and is useful for accessing the field via an interface.

type TeamWorkItemLegacyFields added in v0.18.0 

type TeamWorkItemLegacyFields struct {
	// The record node's id.
	NodeId string `json:"nodeId"`
	// The session the work is attributed to.
	SessionId string `json:"sessionId"`
	// The Worker (named casting) behind the record, when the session was worker-bound.
	WorkerId *string `json:"workerId"`
	// Display convenience, denormalized at write: the session's bound worker name, else the attributed user's handle (pre-#974 records surface their stored personaName here).
	WorkerName string `json:"workerName"`
	// The external tool the artifact lives in ('github', ...). Lowercased.
	Tool string `json:"tool"`
	// Artifact kind: pr, issue, commit, branch, or repo.
	Kind string `json:"kind"`
	// The canonical artifact ref — the equality-lookup key.
	Ref string `json:"ref"`
	// What happened: opened, merged, claimed, reviewed, closed, pushed, ... (free string, lowercased).
	Action string `json:"action"`
	// When the record was made (server-stamped).
	At string `json:"at"`
	// Optional display extras (title, URL) — never filtered on.
	Detail *json.RawMessage `json:"detail"`
}

Old servers lack both TeamWorkItem.model and recordTeamWork(model:). Keep their ordinary logging and provenance reads available when the caller did not require an explicit model. Never use this for --model.

func (*TeamWorkItemLegacyFields) GetAction added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetAction() string

GetAction returns TeamWorkItemLegacyFields.Action, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetAt added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetAt() string

GetAt returns TeamWorkItemLegacyFields.At, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetDetail added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetDetail() *json.RawMessage

GetDetail returns TeamWorkItemLegacyFields.Detail, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetKind added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetKind() string

GetKind returns TeamWorkItemLegacyFields.Kind, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetNodeId added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetNodeId() string

GetNodeId returns TeamWorkItemLegacyFields.NodeId, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetRef added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetRef() string

GetRef returns TeamWorkItemLegacyFields.Ref, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetSessionId added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetSessionId() string

GetSessionId returns TeamWorkItemLegacyFields.SessionId, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetTool added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetTool() string

GetTool returns TeamWorkItemLegacyFields.Tool, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetWorkerId added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetWorkerId() *string

GetWorkerId returns TeamWorkItemLegacyFields.WorkerId, and is useful for accessing the field via an interface.

func (*TeamWorkItemLegacyFields) GetWorkerName added in v0.18.0 

func (v *TeamWorkItemLegacyFields) GetWorkerName() string

GetWorkerName returns TeamWorkItemLegacyFields.WorkerName, and is useful for accessing the field via an interface.

type TeamWorkItemsLegacyResponse added in v0.18.0 

type TeamWorkItemsLegacyResponse struct {
	// Read a team App's worklog (#947) — the provenance query: which sessions
	// (and transcripts) produced this PR? Newest first, as a uniform
	// { items, total } page. ref accepts ANY accepted spelling (URL, short form,
	// canonical) and is matched tool-awarely: with tool 'github' (or none) it is
	// normalized, so 'https://github.com/o/r/pull/371' and 'o/r#371' return the
	// same records. An ownerless github ref such as cli#793 matches every
	// readable canonical ref whose repository ends in cli and number is 793;
	// it never selects one owner. With another tool ref matches the stored
	// verbatim spelling; with no tool it matches either. sessionRef / tool / kind
	// are equality filters; kind must be one of pr, issue, commit, branch, repo
	// when given.
	// limit defaults to 50 (cap 200); limit: 0 returns only total.
	//
	// Authorization: an AppMember of the App (any role), an org member with
	// CONTRIBUTOR+ on the App's org, the owner of a user-owned App, or the
	// App's own key (a pure App-key principal may READ its own App's worklog).
	//
	// appRef accepts the entity's ID or URN; sessionRef is the session id.
	TeamWorkItems *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage `json:"teamWorkItems"`
}

TeamWorkItemsLegacyResponse is returned by TeamWorkItemsLegacy on success.

func TeamWorkItemsLegacy added in v0.18.0 

func TeamWorkItemsLegacy(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	sessionRef *string,
	ref *string,
	kind *string,
	tool *string,
	limit *int,
	offset *int,
) (data_ *TeamWorkItemsLegacyResponse, err_ error)

func (*TeamWorkItemsLegacyResponse) GetTeamWorkItems added in v0.18.0 

func (v *TeamWorkItemsLegacyResponse) GetTeamWorkItems() *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage

GetTeamWorkItems returns TeamWorkItemsLegacyResponse.TeamWorkItems, and is useful for accessing the field via an interface.

type TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage added in v0.18.0 

type TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage struct {
	Total int                                                                   `json:"total"`
	Items []*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem `json:"items"`
}

TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage includes the requested fields of the GraphQL type TeamWorkItemsPage.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage) GetItems added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage) GetItems() []*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem

GetItems returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage.Items, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage) GetTotal added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage) GetTotal() int

GetTotal returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPage.Total, and is useful for accessing the field via an interface.

type TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem added in v0.18.0 

type TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem struct {
	TeamWorkItemLegacyFields `json:"-"`
}

TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem includes the requested fields of the GraphQL type TeamWorkItem. The GraphQL type's documentation follows.

One team-worklog record (#947) — an externally visible work milestone (a PR opened, a branch pushed, an issue closed), append-only. The worklog is the AUTHORITATIVE PR-session join (spec cor:agt:020:03); Session.prNumber is a latest-wins display convenience. ref carries the ONE canonical spelling per artifact (github: owner/repo#N, owner/repo@sha, owner/repo:branch, owner/repo; owner/repo lowercased).

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAction added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAction() string

GetAction returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Action, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAt added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAt() string

GetAt returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.At, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetDetail added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetDetail() *json.RawMessage

GetDetail returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Detail, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetKind added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetKind() string

GetKind returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Kind, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetNodeId added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetNodeId() string

GetNodeId returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.NodeId, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetRef added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetRef() string

GetRef returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Ref, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetSessionId added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetSessionId() string

GetSessionId returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.SessionId, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetTool added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetTool() string

GetTool returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Tool, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerId added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerId() *string

GetWorkerId returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.WorkerId, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerName added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerName() string

GetWorkerName returns TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.WorkerName, and is useful for accessing the field via an interface.

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) MarshalJSON added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) MarshalJSON() ([]byte, error)

func (*TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) UnmarshalJSON added in v0.18.0 

func (v *TeamWorkItemsLegacyTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) UnmarshalJSON(b []byte) error

type TeamWorkItemsResponse added in v0.9.0 

type TeamWorkItemsResponse struct {
	// Read a team App's worklog (#947) — the provenance query: which sessions
	// (and transcripts) produced this PR? Newest first, as a uniform
	// { items, total } page. ref accepts ANY accepted spelling (URL, short form,
	// canonical) and is matched tool-awarely: with tool 'github' (or none) it is
	// normalized, so 'https://github.com/o/r/pull/371' and 'o/r#371' return the
	// same records. An ownerless github ref such as cli#793 matches every
	// readable canonical ref whose repository ends in cli and number is 793;
	// it never selects one owner. With another tool ref matches the stored
	// verbatim spelling; with no tool it matches either. sessionRef / tool / kind
	// are equality filters; kind must be one of pr, issue, commit, branch, repo
	// when given.
	// limit defaults to 50 (cap 200); limit: 0 returns only total.
	//
	// Authorization: an AppMember of the App (any role), an org member with
	// CONTRIBUTOR+ on the App's org, the owner of a user-owned App, or the
	// App's own key (a pure App-key principal may READ its own App's worklog).
	//
	// appRef accepts the entity's ID or URN; sessionRef is the session id.
	TeamWorkItems *TeamWorkItemsTeamWorkItemsTeamWorkItemsPage `json:"teamWorkItems"`
}

TeamWorkItemsResponse is returned by TeamWorkItems on success.

func TeamWorkItems added in v0.9.0 

func TeamWorkItems(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	sessionRef *string,
	ref *string,
	kind *string,
	tool *string,
	limit *int,
	offset *int,
) (data_ *TeamWorkItemsResponse, err_ error)

func (*TeamWorkItemsResponse) GetTeamWorkItems added in v0.9.0 

func (v *TeamWorkItemsResponse) GetTeamWorkItems() *TeamWorkItemsTeamWorkItemsTeamWorkItemsPage

GetTeamWorkItems returns TeamWorkItemsResponse.TeamWorkItems, and is useful for accessing the field via an interface.

type TeamWorkItemsTeamWorkItemsTeamWorkItemsPage added in v0.9.0 

type TeamWorkItemsTeamWorkItemsTeamWorkItemsPage struct {
	Total int                                                             `json:"total"`
	Items []*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem `json:"items"`
}

TeamWorkItemsTeamWorkItemsTeamWorkItemsPage includes the requested fields of the GraphQL type TeamWorkItemsPage.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPage) GetItems added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPage) GetItems() []*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem

GetItems returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPage.Items, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPage) GetTotal added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPage) GetTotal() int

GetTotal returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPage.Total, and is useful for accessing the field via an interface.

type TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem added in v0.9.0 

type TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem struct {
	TeamWorkItemFields `json:"-"`
}

TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem includes the requested fields of the GraphQL type TeamWorkItem. The GraphQL type's documentation follows.

One team-worklog record (#947) — an externally visible work milestone (a PR opened, a branch pushed, an issue closed), append-only. The worklog is the AUTHORITATIVE PR-session join (spec cor:agt:020:03); Session.prNumber is a latest-wins display convenience. ref carries the ONE canonical spelling per artifact (github: owner/repo#N, owner/repo@sha, owner/repo:branch, owner/repo; owner/repo lowercased).

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAction added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAction() string

GetAction returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Action, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAt added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetAt() string

GetAt returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.At, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetDetail added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetDetail() *json.RawMessage

GetDetail returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Detail, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetKind added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetKind() string

GetKind returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Kind, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetModel added in v0.18.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetModel() *string

GetModel returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Model, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetNodeId added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetNodeId() string

GetNodeId returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.NodeId, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetRef added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetRef() string

GetRef returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Ref, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetSessionId added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetSessionId() string

GetSessionId returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.SessionId, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetTool added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetTool() string

GetTool returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.Tool, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerId added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerId() *string

GetWorkerId returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.WorkerId, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerName added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) GetWorkerName() string

GetWorkerName returns TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem.WorkerName, and is useful for accessing the field via an interface.

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) MarshalJSON added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) MarshalJSON() ([]byte, error)

func (*TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) UnmarshalJSON added in v0.9.0 

func (v *TeamWorkItemsTeamWorkItemsTeamWorkItemsPageItemsTeamWorkItem) UnmarshalJSON(b []byte) error

type TransferMemoryOwnershipResponse added in v0.18.0 

type TransferMemoryOwnershipResponse struct {
	// Transfer a free-standing Memory to exactly one new owner. dryRun previews
	// the new URN and dependent handling without writing; apply recomputes under
	// lock and can pin the preview with expectedNewUrn. A class change across
	// user/org ownership must be explicit. The caller needs authority on both
	// sides; unreadable source memories are concealed as not found. Group members
	// block transfer by default; resetGroupMembers explicitly revokes every old
	// membership inside the transfer transaction. A group destination then adds
	// the caller as its first owner-member.
	TransferMemoryOwnership *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview `json:"transferMemoryOwnership"`
}

TransferMemoryOwnershipResponse is returned by TransferMemoryOwnership on success.

func TransferMemoryOwnership added in v0.18.0 

func TransferMemoryOwnership(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	orgRef *string,
	userRef *string,
	targetClass *MemoryClass,
	expectedNewUrn *string,
	resetGroupMembers bool,
	dryRun bool,
) (data_ *TransferMemoryOwnershipResponse, err_ error)

Preview and apply use the same operation. Apply pins expectedNewUrn to the preview's newUrn so a changed destination handle cannot silently move the memory to a different address.

func (*TransferMemoryOwnershipResponse) GetTransferMemoryOwnership added in v0.18.0 

func (v *TransferMemoryOwnershipResponse) GetTransferMemoryOwnership() *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview

GetTransferMemoryOwnership returns TransferMemoryOwnershipResponse.TransferMemoryOwnership, and is useful for accessing the field via an interface.

type TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview added in v0.18.0 

type TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview struct {
	MemoryId     string                                                                                                       `json:"memoryId"`
	OldUrn       string                                                                                                       `json:"oldUrn"`
	NewUrn       string                                                                                                       `json:"newUrn"`
	FromOwner    string                                                                                                       `json:"fromOwner"`
	ToOwner      string                                                                                                       `json:"toOwner"`
	CurrentClass MemoryClass                                                                                                  `json:"currentClass"`
	TargetClass  MemoryClass                                                                                                  `json:"targetClass"`
	Dependents   []*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent `json:"dependents"`
	Blockers     []*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker     `json:"blockers"`
	CanApply     bool                                                                                                         `json:"canApply"`
	Applied      bool                                                                                                         `json:"applied"`
}

TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview includes the requested fields of the GraphQL type MemoryOwnerTransferPreview.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetApplied added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetApplied() bool

GetApplied returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.Applied, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetBlockers added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetBlockers() []*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker

GetBlockers returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.Blockers, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetCanApply added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetCanApply() bool

GetCanApply returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.CanApply, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetCurrentClass added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetCurrentClass() MemoryClass

GetCurrentClass returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.CurrentClass, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetDependents added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetDependents() []*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent

GetDependents returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.Dependents, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetFromOwner added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetFromOwner() string

GetFromOwner returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.FromOwner, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetMemoryId added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetMemoryId() string

GetMemoryId returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.MemoryId, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetNewUrn added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetNewUrn() string

GetNewUrn returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.NewUrn, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetOldUrn added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetOldUrn() string

GetOldUrn returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.OldUrn, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetTargetClass added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetTargetClass() MemoryClass

GetTargetClass returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.TargetClass, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetToOwner added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview) GetToOwner() string

GetToOwner returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreview.ToOwner, and is useful for accessing the field via an interface.

type TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker added in v0.18.0 

type TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker includes the requested fields of the GraphQL type MemoryTransferBlocker.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker) GetCode added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker) GetCode() string

GetCode returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker.Code, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker) GetMessage added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker) GetMessage() string

GetMessage returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewBlockersMemoryTransferBlocker.Message, and is useful for accessing the field via an interface.

type TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent added in v0.18.0 

type TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent struct {
	Kind     string                 `json:"kind"`
	Count    int                    `json:"count"`
	Handling MemoryTransferHandling `json:"handling"`
}

TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent includes the requested fields of the GraphQL type MemoryTransferDependent.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent) GetCount added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent) GetCount() int

GetCount returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent.Count, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent) GetHandling added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent) GetHandling() MemoryTransferHandling

GetHandling returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent.Handling, and is useful for accessing the field via an interface.

func (*TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent) GetKind added in v0.18.0 

func (v *TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent) GetKind() string

GetKind returns TransferMemoryOwnershipTransferMemoryOwnershipMemoryOwnerTransferPreviewDependentsMemoryTransferDependent.Kind, and is useful for accessing the field via an interface.

type TriggerAppRunInput added in v0.6.0 

type TriggerAppRunInput struct {
	AiConfigName *string `json:"aiConfigName,omitempty"`
	// App — ref: PK or fully-qualified URN.
	AppRef       string           `json:"appRef"`
	EntryNodeUrn string           `json:"entryNodeUrn"`
	EventData    *json.RawMessage `json:"eventData,omitempty"`
	RunAsSelf    *bool            `json:"runAsSelf,omitempty"`
}

func (*TriggerAppRunInput) GetAiConfigName added in v0.6.0 

func (v *TriggerAppRunInput) GetAiConfigName() *string

GetAiConfigName returns TriggerAppRunInput.AiConfigName, and is useful for accessing the field via an interface.

func (*TriggerAppRunInput) GetAppRef added in v0.7.0 

func (v *TriggerAppRunInput) GetAppRef() string

GetAppRef returns TriggerAppRunInput.AppRef, and is useful for accessing the field via an interface.

func (*TriggerAppRunInput) GetEntryNodeUrn added in v0.6.0 

func (v *TriggerAppRunInput) GetEntryNodeUrn() string

GetEntryNodeUrn returns TriggerAppRunInput.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*TriggerAppRunInput) GetEventData added in v0.6.0 

func (v *TriggerAppRunInput) GetEventData() *json.RawMessage

GetEventData returns TriggerAppRunInput.EventData, and is useful for accessing the field via an interface.

func (*TriggerAppRunInput) GetRunAsSelf added in v0.6.0 

func (v *TriggerAppRunInput) GetRunAsSelf() *bool

GetRunAsSelf returns TriggerAppRunInput.RunAsSelf, and is useful for accessing the field via an interface.

type TriggerAppRunResponse added in v0.6.0 

type TriggerAppRunResponse struct {
	// Run an entry node now (MANUAL trigger) — same launch gate + kernel as a schedule.
	TriggerAppRun *TriggerAppRunTriggerAppRun `json:"triggerAppRun"`
}

TriggerAppRunResponse is returned by TriggerAppRun on success.

func TriggerAppRun added in v0.6.0 

func TriggerAppRun(
	ctx_ context.Context,
	client_ graphql.Client,
	input *TriggerAppRunInput,
) (data_ *TriggerAppRunResponse, err_ error)

MANUAL trigger. runAsSelf requires an authenticated user (an App-key caller gets UNAUTHENTICATED). eventData carries the template args.

The server reads an omitted optional input field as "unset"; nil pointers must be omitted, not sent as null — hence the per-field omitempty directives (the NodeInput contract in nodes.graphql). Load-bearing on the Update* inputs, where an explicit null means "clear".

func (*TriggerAppRunResponse) GetTriggerAppRun added in v0.6.0 

func (v *TriggerAppRunResponse) GetTriggerAppRun() *TriggerAppRunTriggerAppRun

GetTriggerAppRun returns TriggerAppRunResponse.TriggerAppRun, and is useful for accessing the field via an interface.

type TriggerAppRunTriggerAppRun added in v0.6.0 

type TriggerAppRunTriggerAppRun struct {
	AppRunFields `json:"-"`
}

TriggerAppRunTriggerAppRun includes the requested fields of the GraphQL type AppRun. The GraphQL type's documentation follows.

One headless run — the audit record AND (v1) the activation: policy snapshot, live budgets (zeroing halts the run), lifecycle, trigger provenance. Spec cor:agt:010:02.

func (*TriggerAppRunTriggerAppRun) GetAgentId added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetAgentId() *string

GetAgentId returns TriggerAppRunTriggerAppRun.AgentId, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetAppId added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetAppId() string

GetAppId returns TriggerAppRunTriggerAppRun.AppId, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetAttempts added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetAttempts() int

GetAttempts returns TriggerAppRunTriggerAppRun.Attempts, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetBudgetActions added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetBudgetActions() *int

GetBudgetActions returns TriggerAppRunTriggerAppRun.BudgetActions, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetBudgetTokens added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetBudgetTokens() *int

GetBudgetTokens returns TriggerAppRunTriggerAppRun.BudgetTokens, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetCreatedAt added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetCreatedAt() string

GetCreatedAt returns TriggerAppRunTriggerAppRun.CreatedAt, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetCreatedBy added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetCreatedBy() *string

GetCreatedBy returns TriggerAppRunTriggerAppRun.CreatedBy, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetCurNodeUrn added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetCurNodeUrn() *string

GetCurNodeUrn returns TriggerAppRunTriggerAppRun.CurNodeUrn, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetData added in v0.7.0 

func (v *TriggerAppRunTriggerAppRun) GetData() *json.RawMessage

GetData returns TriggerAppRunTriggerAppRun.Data, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetEntryNodeUrn added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetEntryNodeUrn() string

GetEntryNodeUrn returns TriggerAppRunTriggerAppRun.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetEventData added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetEventData() *json.RawMessage

GetEventData returns TriggerAppRunTriggerAppRun.EventData, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetFailure added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetFailure() *json.RawMessage

GetFailure returns TriggerAppRunTriggerAppRun.Failure, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetFinishedAt added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetFinishedAt() *string

GetFinishedAt returns TriggerAppRunTriggerAppRun.FinishedAt, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetId added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetId() string

GetId returns TriggerAppRunTriggerAppRun.Id, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetOrganizationId added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetOrganizationId() string

GetOrganizationId returns TriggerAppRunTriggerAppRun.OrganizationId, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetParentRunId added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetParentRunId() *string

GetParentRunId returns TriggerAppRunTriggerAppRun.ParentRunId, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetPolicy added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetPolicy() *json.RawMessage

GetPolicy returns TriggerAppRunTriggerAppRun.Policy, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetStartedAt added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetStartedAt() *string

GetStartedAt returns TriggerAppRunTriggerAppRun.StartedAt, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetStatus added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetStatus() AppRunStatus

GetStatus returns TriggerAppRunTriggerAppRun.Status, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetTimeoutMs added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetTimeoutMs() *int

GetTimeoutMs returns TriggerAppRunTriggerAppRun.TimeoutMs, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetTriggerId added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetTriggerId() *string

GetTriggerId returns TriggerAppRunTriggerAppRun.TriggerId, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetTriggerKind added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetTriggerKind() AppRunTriggerKind

GetTriggerKind returns TriggerAppRunTriggerAppRun.TriggerKind, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) GetUserId added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) GetUserId() *string

GetUserId returns TriggerAppRunTriggerAppRun.UserId, and is useful for accessing the field via an interface.

func (*TriggerAppRunTriggerAppRun) MarshalJSON added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) MarshalJSON() ([]byte, error)

func (*TriggerAppRunTriggerAppRun) UnmarshalJSON added in v0.6.0 

func (v *TriggerAppRunTriggerAppRun) UnmarshalJSON(b []byte) error

type UninstallAgentFromAppResponse added in v0.9.0 

type UninstallAgentFromAppResponse struct {
	// Uninstall an Agent from an App. Deletes the AppAgent row. The Agent's
	// per-(App, Agent, *) memories are NOT cascade-deleted (spec 023 FR-005);
	// they persist as orphans and become reachable again if the same Agent
	// is later reinstalled.
	//
	// Idempotent — succeeds whether or not the AppAgent row exists.
	//
	// Accepts the entity's ID or URN.
	UninstallAgentFromApp *UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload `json:"uninstallAgentFromApp"`
}

UninstallAgentFromAppResponse is returned by UninstallAgentFromApp on success.

func UninstallAgentFromApp added in v0.9.0 

func UninstallAgentFromApp(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	agentRef string,
) (data_ *UninstallAgentFromAppResponse, err_ error)

Idempotent server-side: succeeds whether or not the AppAgent row exists. The Agent's per-(App, Agent, *) memories are NOT cascade-deleted (spec 023 FR-005) — they persist as orphans and become reachable again on reinstall, which is the retention promise cor:dmo:050:03 makes and #389 exists to make reachable.

func (*UninstallAgentFromAppResponse) GetUninstallAgentFromApp added in v0.9.0 

func (v *UninstallAgentFromAppResponse) GetUninstallAgentFromApp() *UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload

GetUninstallAgentFromApp returns UninstallAgentFromAppResponse.UninstallAgentFromApp, and is useful for accessing the field via an interface.

type UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload added in v0.9.0 

type UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload struct {
	AgentId string `json:"agentId"`
	AppId   string `json:"appId"`
}

UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload includes the requested fields of the GraphQL type UninstallAgentFromAppPayload. The GraphQL type's documentation follows.

Return shape for the uninstallAgentFromApp mutation. The Agent's per-(App, Agent, *) memories are NOT cascade-deleted (spec 023 FR-005); they persist as orphans on the now-removed AppAgent edge.

func (*UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload) GetAgentId added in v0.9.0 

func (v *UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload) GetAgentId() string

GetAgentId returns UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload.AgentId, and is useful for accessing the field via an interface.

func (*UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload) GetAppId added in v0.9.0 

func (v *UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload) GetAppId() string

GetAppId returns UninstallAgentFromAppUninstallAgentFromAppUninstallAgentFromAppPayload.AppId, and is useful for accessing the field via an interface.

type UnlockNodeRoleRuleResponse added in v0.19.0 

type UnlockNodeRoleRuleResponse struct {
	// #1334 — the deliberate step before a rule a required template LOCKED can be
	// edited or deleted (Holger, 2026-09-27: nobody changes a locked rule through
	// an ordinary edit). Needs lock authority: an org ADMIN/OWNER of the memory's
	// org; on a personal/private or org-less memory, its manager. Anyone else who
	// manages the memory gets RULE_LOCKED. Visible: bumps revision and stamps
	// updatedBy. Unlocking an unlocked rule changes nothing. expectedRevision as
	// for updateNodeRoleRule.
	UnlockNodeRoleRule *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload `json:"unlockNodeRoleRule"`
}

UnlockNodeRoleRuleResponse is returned by UnlockNodeRoleRule on success.

func UnlockNodeRoleRule added in v0.19.0 

func UnlockNodeRoleRule(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	expectedRevision int,
) (data_ *UnlockNodeRoleRuleResponse, err_ error)

hadron-server#1334 — the deliberate step before a LOCKED rule (written by a required template) can be edited or removed: a locked rule refuses every ordinary update and delete, for every caller (Holger, 2026-09-27). Needs lock authority; anyone else who manages the memory gets RULE_LOCKED. Unlocking an unlocked rule changes nothing.

func (*UnlockNodeRoleRuleResponse) GetUnlockNodeRoleRule added in v0.19.0 

func (v *UnlockNodeRoleRuleResponse) GetUnlockNodeRoleRule() *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload

GetUnlockNodeRoleRule returns UnlockNodeRoleRuleResponse.UnlockNodeRoleRule, and is useful for accessing the field via an interface.

type UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload added in v0.19.0 

type UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload struct {
	Rule *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule `json:"rule"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning `json:"warnings"`
}

UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload includes the requested fields of the GraphQL type NodeRoleRulePayload.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload) GetRule added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload) GetRule() *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule

GetRule returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload.Rule, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload) GetWarnings added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload) GetWarnings() []*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning

GetWarnings returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayload.Warnings, and is useful for accessing the field via an interface.

type UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule added in v0.19.0 

type UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule struct {
	NodeRoleRuleFields `json:"-"`
}

UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule includes the requested fields of the GraphQL type NodeRoleRule. The GraphQL type's documentation follows.

#1325 — one node-role rule. Task and description references are stored by node id (they survive moves) and returned as a URN and an id, each with its state. Both are given only when the state is OK; see NodeRoleRuleRefState.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask() *string

GetAuthorTask returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTask, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId() *string

GetAuthorTaskId returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskId, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskState, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt() string

GetCreatedAt returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedAt, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy() *string

GetCreatedBy returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedBy, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode() *string

GetDescriptionNode returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNode, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId() *string

GetDescriptionNodeId returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled() bool

GetEnabled returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Enabled, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId() string

GetId returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Id, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked() bool

GetLocked returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Locked, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision() int

GetRevision returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Revision, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole() string

GetRole returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Role, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate() *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate

GetSourceTemplate returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplate, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId() *string

GetSourceTemplateId returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplateId, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles() bool

GetStrictSubRoles returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.StrictSubRoles, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt() *string

GetUpdatedAt returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedAt, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy() *string

GetUpdatedBy returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedBy, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy() *ContentValidator

GetValidateBy returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidateBy, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask() *string

GetValidationTask returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTask, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId() *string

GetValidationTaskId returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskId, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskState, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters() NodeRoleWriters

GetWriters returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Writers, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON() ([]byte, error)

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON(b []byte) error

type UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning added in v0.19.0 

type UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode() string

GetCode returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField() *string

GetField returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole() string

GetRole returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON added in v0.19.0 

func (v *UnlockNodeRoleRuleUnlockNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type UpdateAgentResponse added in v0.7.0 

type UpdateAgentResponse struct {
	// Update an Agent.
	//
	// urn renames the slug (org-owned agents only). personaRole is normalized
	// (explicit null or blank clears, omitted preserves). Worker castings
	// referencing this agent are unaffected —
	// the named identity lives on the Worker.
	//
	// Accepts the entity's ID or URN.
	UpdateAgent *UpdateAgentUpdateAgent `json:"updateAgent"`
}

UpdateAgentResponse is returned by UpdateAgent on success.

func UpdateAgent added in v0.7.0 

func UpdateAgent(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	name *string,
	description *string,
	agentType *AgentType,
	visibility *AgentVisibility,
	systemPrompt *string,
	systemMemoryId *string,
	surfaces []string,
	urn *string,
	personaRole *string,
) (data_ *UpdateAgentResponse, err_ error)

func (*UpdateAgentResponse) GetUpdateAgent added in v0.7.0 

func (v *UpdateAgentResponse) GetUpdateAgent() *UpdateAgentUpdateAgent

GetUpdateAgent returns UpdateAgentResponse.UpdateAgent, and is useful for accessing the field via an interface.

type UpdateAgentScheduleInput added in v0.6.0 

type UpdateAgentScheduleInput struct {
	// Agent — ref: PK or URN; must be installed in the App.
	AgentRef     *string `json:"agentRef,omitempty"`
	AiConfigName *string `json:"aiConfigName,omitempty"`
	// Providing cron switches the schedule to recurring (clears runAt).
	Cron         *string          `json:"cron,omitempty"`
	Enabled      *bool            `json:"enabled,omitempty"`
	EntryNodeUrn *string          `json:"entryNodeUrn,omitempty"`
	EventData    *json.RawMessage `json:"eventData,omitempty"`
	Name         *string          `json:"name,omitempty"`
	Policy       *json.RawMessage `json:"policy,omitempty"`
	RunAsSelf    *bool            `json:"runAsSelf,omitempty"`
	// Providing runAt switches the schedule to one-shot (clears cron). At most one of cron / runAt per call.
	RunAt *string `json:"runAt,omitempty"`
	// Spec 049: set the trigger's scope (id or name in the App's context); an empty string clears it back to 'app'.
	ScopeRef *string `json:"scopeRef,omitempty"`
	Timezone *string `json:"timezone,omitempty"`
}

func (*UpdateAgentScheduleInput) GetAgentRef added in v0.7.0 

func (v *UpdateAgentScheduleInput) GetAgentRef() *string

GetAgentRef returns UpdateAgentScheduleInput.AgentRef, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetAiConfigName added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetAiConfigName() *string

GetAiConfigName returns UpdateAgentScheduleInput.AiConfigName, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetCron added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetCron() *string

GetCron returns UpdateAgentScheduleInput.Cron, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetEnabled added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetEnabled() *bool

GetEnabled returns UpdateAgentScheduleInput.Enabled, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetEntryNodeUrn added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetEntryNodeUrn() *string

GetEntryNodeUrn returns UpdateAgentScheduleInput.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetEventData added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetEventData() *json.RawMessage

GetEventData returns UpdateAgentScheduleInput.EventData, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetName added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetName() *string

GetName returns UpdateAgentScheduleInput.Name, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetPolicy added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetPolicy() *json.RawMessage

GetPolicy returns UpdateAgentScheduleInput.Policy, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetRunAsSelf added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetRunAsSelf() *bool

GetRunAsSelf returns UpdateAgentScheduleInput.RunAsSelf, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetRunAt added in v0.7.0 

func (v *UpdateAgentScheduleInput) GetRunAt() *string

GetRunAt returns UpdateAgentScheduleInput.RunAt, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetScopeRef added in v0.14.0 

func (v *UpdateAgentScheduleInput) GetScopeRef() *string

GetScopeRef returns UpdateAgentScheduleInput.ScopeRef, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleInput) GetTimezone added in v0.6.0 

func (v *UpdateAgentScheduleInput) GetTimezone() *string

GetTimezone returns UpdateAgentScheduleInput.Timezone, and is useful for accessing the field via an interface.

type UpdateAgentScheduleResponse added in v0.6.0 

type UpdateAgentScheduleResponse struct {
	UpdateAgentSchedule *UpdateAgentScheduleUpdateAgentSchedule `json:"updateAgentSchedule"`
}

UpdateAgentScheduleResponse is returned by UpdateAgentSchedule on success.

func UpdateAgentSchedule added in v0.6.0 

func UpdateAgentSchedule(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	input *UpdateAgentScheduleInput,
) (data_ *UpdateAgentScheduleResponse, err_ error)

Every field optional. An omitted field preserves; an explicit null clears — so unset flags MUST be omitted (nil pointers dropped by these directives). scopeRef arrived with spec-049 Phase 3b (hadron-server#1163); without this an unrelated `schedule update --name …` sends scopeRef:null and CLEARS the scope.

func (*UpdateAgentScheduleResponse) GetUpdateAgentSchedule added in v0.6.0 

func (v *UpdateAgentScheduleResponse) GetUpdateAgentSchedule() *UpdateAgentScheduleUpdateAgentSchedule

GetUpdateAgentSchedule returns UpdateAgentScheduleResponse.UpdateAgentSchedule, and is useful for accessing the field via an interface.

type UpdateAgentScheduleUpdateAgentSchedule added in v0.6.0 

type UpdateAgentScheduleUpdateAgentSchedule struct {
	AgentScheduleFields `json:"-"`
}

UpdateAgentScheduleUpdateAgentSchedule includes the requested fields of the GraphQL type AgentSchedule. The GraphQL type's documentation follows.

Recurring trigger (cor:agt:010, D-2026-07-04-E).

func (*UpdateAgentScheduleUpdateAgentSchedule) GetAgentId added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetAgentId() *string

GetAgentId returns UpdateAgentScheduleUpdateAgentSchedule.AgentId, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetAiConfigName added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetAiConfigName() *string

GetAiConfigName returns UpdateAgentScheduleUpdateAgentSchedule.AiConfigName, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetAppId added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetAppId() string

GetAppId returns UpdateAgentScheduleUpdateAgentSchedule.AppId, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetCreatedAt added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetCreatedAt() string

GetCreatedAt returns UpdateAgentScheduleUpdateAgentSchedule.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetCreatedBy added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetCreatedBy() *string

GetCreatedBy returns UpdateAgentScheduleUpdateAgentSchedule.CreatedBy, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetCron added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetCron() *string

GetCron returns UpdateAgentScheduleUpdateAgentSchedule.Cron, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetEnabled added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetEnabled() bool

GetEnabled returns UpdateAgentScheduleUpdateAgentSchedule.Enabled, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetEntryNodeUrn added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetEntryNodeUrn() string

GetEntryNodeUrn returns UpdateAgentScheduleUpdateAgentSchedule.EntryNodeUrn, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetEventData added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetEventData() *json.RawMessage

GetEventData returns UpdateAgentScheduleUpdateAgentSchedule.EventData, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetId added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetId() string

GetId returns UpdateAgentScheduleUpdateAgentSchedule.Id, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetLastRunAt added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetLastRunAt() *string

GetLastRunAt returns UpdateAgentScheduleUpdateAgentSchedule.LastRunAt, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetName added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetName() string

GetName returns UpdateAgentScheduleUpdateAgentSchedule.Name, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetNextRunAt added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetNextRunAt() *string

GetNextRunAt returns UpdateAgentScheduleUpdateAgentSchedule.NextRunAt, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetOrganizationId added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetOrganizationId() string

GetOrganizationId returns UpdateAgentScheduleUpdateAgentSchedule.OrganizationId, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetPolicy added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetPolicy() *json.RawMessage

GetPolicy returns UpdateAgentScheduleUpdateAgentSchedule.Policy, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetTimezone added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetTimezone() string

GetTimezone returns UpdateAgentScheduleUpdateAgentSchedule.Timezone, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) GetUserId added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) GetUserId() *string

GetUserId returns UpdateAgentScheduleUpdateAgentSchedule.UserId, and is useful for accessing the field via an interface.

func (*UpdateAgentScheduleUpdateAgentSchedule) MarshalJSON added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) MarshalJSON() ([]byte, error)

func (*UpdateAgentScheduleUpdateAgentSchedule) UnmarshalJSON added in v0.6.0 

func (v *UpdateAgentScheduleUpdateAgentSchedule) UnmarshalJSON(b []byte) error

type UpdateAgentUpdateAgent added in v0.7.0 

type UpdateAgentUpdateAgent struct {
	AgentFields `json:"-"`
}

UpdateAgentUpdateAgent includes the requested fields of the GraphQL type Agent. The GraphQL type's documentation follows.

The reusable definition a Builder creates and the marketplace can list. Agents are installed into runtime Apps through the AppAgent N:M join: an App may install many Agents, and an Agent may be installed in many Apps. The App, not the Agent, is the org- or user-owned caller identity and deployment.

func (*UpdateAgentUpdateAgent) GetAiModel added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetAiModel() *string

GetAiModel returns UpdateAgentUpdateAgent.AiModel, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetAiProvider added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetAiProvider() *string

GetAiProvider returns UpdateAgentUpdateAgent.AiProvider, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetCreatedAt added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetCreatedAt() string

GetCreatedAt returns UpdateAgentUpdateAgent.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetDescription added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetDescription() *string

GetDescription returns UpdateAgentUpdateAgent.Description, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetHasAiApiKey added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetHasAiApiKey() bool

GetHasAiApiKey returns UpdateAgentUpdateAgent.HasAiApiKey, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetId added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetId() string

GetId returns UpdateAgentUpdateAgent.Id, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetName added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetName() string

GetName returns UpdateAgentUpdateAgent.Name, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetOrganizationId added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetOrganizationId() *string

GetOrganizationId returns UpdateAgentUpdateAgent.OrganizationId, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetPersonaRole added in v0.9.0 

func (v *UpdateAgentUpdateAgent) GetPersonaRole() *string

GetPersonaRole returns UpdateAgentUpdateAgent.PersonaRole, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetSurfaces added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetSurfaces() []string

GetSurfaces returns UpdateAgentUpdateAgent.Surfaces, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetSystemMemoryId added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetSystemMemoryId() *string

GetSystemMemoryId returns UpdateAgentUpdateAgent.SystemMemoryId, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetSystemPrompt added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetSystemPrompt() *string

GetSystemPrompt returns UpdateAgentUpdateAgent.SystemPrompt, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetType added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetType() AgentType

GetType returns UpdateAgentUpdateAgent.Type, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetUrn added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetUrn() string

GetUrn returns UpdateAgentUpdateAgent.Urn, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) GetVisibility added in v0.7.0 

func (v *UpdateAgentUpdateAgent) GetVisibility() AgentVisibility

GetVisibility returns UpdateAgentUpdateAgent.Visibility, and is useful for accessing the field via an interface.

func (*UpdateAgentUpdateAgent) MarshalJSON added in v0.7.0 

func (v *UpdateAgentUpdateAgent) MarshalJSON() ([]byte, error)

func (*UpdateAgentUpdateAgent) UnmarshalJSON added in v0.7.0 

func (v *UpdateAgentUpdateAgent) UnmarshalJSON(b []byte) error

type UpdateAiServiceConfigResponse added in v0.3.0 

type UpdateAiServiceConfigResponse struct {
	// 036-ai-service-config: update a named AI config. All fields optional.
	//
	// apiKey semantics: omitted = keep the stored key; empty string =
	// clear it; non-empty = replace (encrypted, preview recomputed). The
	// RESULTING config is held to createAiServiceConfig's key rule, so
	// clearing the key of a config that needs one is refused.
	//
	// Auth: admin rights on the owning entity (as aiServiceConfigs).
	UpdateAiServiceConfig *UpdateAiServiceConfigUpdateAiServiceConfig `json:"updateAiServiceConfig"`
}

UpdateAiServiceConfigResponse is returned by UpdateAiServiceConfig on success.

func UpdateAiServiceConfig added in v0.3.0 

func UpdateAiServiceConfig(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	name *string,
	provider *string,
	model *string,
	apiKey *string,
	enabled *bool,
	params *json.RawMessage,
) (data_ *UpdateAiServiceConfigResponse, err_ error)

All fields optional. apiKey: omitted (nil) = keep the stored key; "" = clear it; non-empty = replace. nil-based omitempty makes a non-nil &"" send the empty string (the clear signal), while an absent flag stays nil and is omitted (preserve).

func (*UpdateAiServiceConfigResponse) GetUpdateAiServiceConfig added in v0.3.0 

func (v *UpdateAiServiceConfigResponse) GetUpdateAiServiceConfig() *UpdateAiServiceConfigUpdateAiServiceConfig

GetUpdateAiServiceConfig returns UpdateAiServiceConfigResponse.UpdateAiServiceConfig, and is useful for accessing the field via an interface.

type UpdateAiServiceConfigUpdateAiServiceConfig added in v0.3.0 

type UpdateAiServiceConfigUpdateAiServiceConfig struct {
	AiServiceConfigFields `json:"-"`
}

UpdateAiServiceConfigUpdateAiServiceConfig includes the requested fields of the GraphQL type AiServiceConfig. The GraphQL type's documentation follows.

036-ai-service-config: a named AI service configuration (masked management view — never carries key material beyond the preview). Owned by exactly one of HadronServer / Organization / App / Agent. Resolution walks App -> Agent -> Org (of the App) -> HadronServer and returns the first ENABLED config with the requested name. Well-known fallback name: 'default' (conventional extras: 'fast', 'frontier'). Name is unique per owner.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetApiKeyPreview added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetApiKeyPreview() *string

GetApiKeyPreview returns UpdateAiServiceConfigUpdateAiServiceConfig.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetCreatedAt added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetCreatedAt() string

GetCreatedAt returns UpdateAiServiceConfigUpdateAiServiceConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetEnabled added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetEnabled() bool

GetEnabled returns UpdateAiServiceConfigUpdateAiServiceConfig.Enabled, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetHasApiKey added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetHasApiKey() bool

GetHasApiKey returns UpdateAiServiceConfigUpdateAiServiceConfig.HasApiKey, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetId added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetId() string

GetId returns UpdateAiServiceConfigUpdateAiServiceConfig.Id, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetModel added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetModel() string

GetModel returns UpdateAiServiceConfigUpdateAiServiceConfig.Model, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetName added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetName() string

GetName returns UpdateAiServiceConfigUpdateAiServiceConfig.Name, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetOwnerId added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetOwnerId() string

GetOwnerId returns UpdateAiServiceConfigUpdateAiServiceConfig.OwnerId, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetOwnerType added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetOwnerType() AiConfigOwnerType

GetOwnerType returns UpdateAiServiceConfigUpdateAiServiceConfig.OwnerType, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetParams added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetParams() *json.RawMessage

GetParams returns UpdateAiServiceConfigUpdateAiServiceConfig.Params, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetProvider added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetProvider() string

GetProvider returns UpdateAiServiceConfigUpdateAiServiceConfig.Provider, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) GetUpdatedAt added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) GetUpdatedAt() *string

GetUpdatedAt returns UpdateAiServiceConfigUpdateAiServiceConfig.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigUpdateAiServiceConfig) MarshalJSON added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) MarshalJSON() ([]byte, error)

func (*UpdateAiServiceConfigUpdateAiServiceConfig) UnmarshalJSON added in v0.3.0 

func (v *UpdateAiServiceConfigUpdateAiServiceConfig) UnmarshalJSON(b []byte) error

type UpdateAiServiceConfigWithEndpointResponse added in v0.18.0 

type UpdateAiServiceConfigWithEndpointResponse struct {
	// 036-ai-service-config: update a named AI config. All fields optional.
	//
	// apiKey semantics: omitted = keep the stored key; empty string =
	// clear it; non-empty = replace (encrypted, preview recomputed). The
	// RESULTING config is held to createAiServiceConfig's key rule, so
	// clearing the key of a config that needs one is refused.
	//
	// Auth: admin rights on the owning entity (as aiServiceConfigs).
	UpdateAiServiceConfig *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig `json:"updateAiServiceConfig"`
}

UpdateAiServiceConfigWithEndpointResponse is returned by UpdateAiServiceConfigWithEndpoint on success.

func UpdateAiServiceConfigWithEndpoint added in v0.18.0 

func UpdateAiServiceConfigWithEndpoint(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	name *string,
	provider *string,
	model *string,
	apiKey *string,
	enabled *bool,
	params *json.RawMessage,
	endpoint *string,
) (data_ *UpdateAiServiceConfigWithEndpointResponse, err_ error)

A nil endpoint pointer is omitted (preserve); a non-nil empty string is sent and the server clears the override. An explicit null is not needed because the final server contract also accepts the empty string as clear.

func (*UpdateAiServiceConfigWithEndpointResponse) GetUpdateAiServiceConfig added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointResponse) GetUpdateAiServiceConfig() *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig

GetUpdateAiServiceConfig returns UpdateAiServiceConfigWithEndpointResponse.UpdateAiServiceConfig, and is useful for accessing the field via an interface.

type UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig added in v0.18.0 

type UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig struct {
	AiServiceConfigEndpointFields `json:"-"`
}

UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig includes the requested fields of the GraphQL type AiServiceConfig. The GraphQL type's documentation follows.

036-ai-service-config: a named AI service configuration (masked management view — never carries key material beyond the preview). Owned by exactly one of HadronServer / Organization / App / Agent. Resolution walks App -> Agent -> Org (of the App) -> HadronServer and returns the first ENABLED config with the requested name. Well-known fallback name: 'default' (conventional extras: 'fast', 'frontier'). Name is unique per owner.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetApiKeyPreview added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetApiKeyPreview() *string

GetApiKeyPreview returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.ApiKeyPreview, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetCreatedAt added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetCreatedAt() string

GetCreatedAt returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetEffectiveEndpoint added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetEffectiveEndpoint() *string

GetEffectiveEndpoint returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.EffectiveEndpoint, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetEnabled added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetEnabled() bool

GetEnabled returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.Enabled, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetEndpoint added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetEndpoint() *string

GetEndpoint returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.Endpoint, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetHasApiKey added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetHasApiKey() bool

GetHasApiKey returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.HasApiKey, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetId added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetId() string

GetId returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.Id, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetModel added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetModel() string

GetModel returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.Model, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetName added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetName() string

GetName returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.Name, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetOwnerId added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetOwnerId() string

GetOwnerId returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.OwnerId, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetOwnerType added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetOwnerType() AiConfigOwnerType

GetOwnerType returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.OwnerType, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetParams added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetParams() *json.RawMessage

GetParams returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.Params, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetProvider added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetProvider() string

GetProvider returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.Provider, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetUpdatedAt added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) GetUpdatedAt() *string

GetUpdatedAt returns UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) MarshalJSON added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) MarshalJSON() ([]byte, error)

func (*UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) UnmarshalJSON added in v0.18.0 

func (v *UpdateAiServiceConfigWithEndpointUpdateAiServiceConfig) UnmarshalJSON(b []byte) error

type UpdateChannelInput added in v0.14.0 

type UpdateChannelInput struct {
	Description *string `json:"description,omitempty"`
	Name        *string `json:"name,omitempty"`
}

func (*UpdateChannelInput) GetDescription added in v0.14.0 

func (v *UpdateChannelInput) GetDescription() *string

GetDescription returns UpdateChannelInput.Description, and is useful for accessing the field via an interface.

func (*UpdateChannelInput) GetName added in v0.14.0 

func (v *UpdateChannelInput) GetName() *string

GetName returns UpdateChannelInput.Name, and is useful for accessing the field via an interface.

type UpdateChannelResponse added in v0.14.0 

type UpdateChannelResponse struct {
	// Spec 049 Phase 4 — rename / re-describe a Channel whose host memory you may write. ref: its id or its address (Channel.chatRootUrn, #1171).
	UpdateChannel *UpdateChannelUpdateChannel `json:"updateChannel"`
}

UpdateChannelResponse is returned by UpdateChannel on success.

func UpdateChannel added in v0.14.0 

func UpdateChannel(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	input *UpdateChannelInput,
) (data_ *UpdateChannelResponse, err_ error)

Rename / re-describe a Channel whose host memory the caller may write.

WIRE SEMANTICS: an OMITTED input field preserves, an explicit null clears — so both optional fields carry omitempty and a nil pointer is omitted rather than sent as null. Dropping either makes an unset flag silently clear a field (CLAUDE.md; findings:a-schema-refresh-can-regress-an-unrelated-write).

The `for:` directives only bind when the variable list is on its own lines (findings:genqlient-for-directive-needs-multiline-signature) — keep this signature expanded.

func (*UpdateChannelResponse) GetUpdateChannel added in v0.14.0 

func (v *UpdateChannelResponse) GetUpdateChannel() *UpdateChannelUpdateChannel

GetUpdateChannel returns UpdateChannelResponse.UpdateChannel, and is useful for accessing the field via an interface.

type UpdateChannelUpdateChannel added in v0.14.0 

type UpdateChannelUpdateChannel struct {
	ChannelFields `json:"-"`
	ChannelMemory `json:"-"`
}

UpdateChannelUpdateChannel includes the requested fields of the GraphQL type Channel. The GraphQL type's documentation follows.

A CHANNEL (spec 049, D-2026-09-13-006): a durable, ordered message stream hosted in ONE memory at ONE reserved address, server-ordered and server-attributed — a platform entity, created one-to-one with its chat root. Creating it RESERVES and PROTECTS the address: generic node writes under it are refused (LOC_PROTECTED); its own operations (createTeamChatMessage, hadron_team_chat_post) are the only writers. The audience is the host memory's (cor:acl:030:01) — a Channel has no access layer of its own. `lastSeq` / `lastMessageAt` are the platform-maintained watermark.

func (*UpdateChannelUpdateChannel) GetChatRootNodeId added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetChatRootNodeId() string

GetChatRootNodeId returns UpdateChannelUpdateChannel.ChatRootNodeId, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetChatRootUrn added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetChatRootUrn() *string

GetChatRootUrn returns UpdateChannelUpdateChannel.ChatRootUrn, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetCreatedAt added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetCreatedAt() string

GetCreatedAt returns UpdateChannelUpdateChannel.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetDescription added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetDescription() *string

GetDescription returns UpdateChannelUpdateChannel.Description, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetId added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetId() string

GetId returns UpdateChannelUpdateChannel.Id, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetKind added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetKind() ChannelKind

GetKind returns UpdateChannelUpdateChannel.Kind, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetLastMessageAt added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetLastMessageAt() *string

GetLastMessageAt returns UpdateChannelUpdateChannel.LastMessageAt, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetLastSeq added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetLastSeq() int

GetLastSeq returns UpdateChannelUpdateChannel.LastSeq, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetLoc added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetLoc() string

GetLoc returns UpdateChannelUpdateChannel.Loc, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetMemory added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetMemory() *ChannelMemoryMemory

GetMemory returns UpdateChannelUpdateChannel.Memory, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetMemoryId added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetMemoryId() string

GetMemoryId returns UpdateChannelUpdateChannel.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetName added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetName() string

GetName returns UpdateChannelUpdateChannel.Name, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) GetUpdatedAt added in v0.14.0 

func (v *UpdateChannelUpdateChannel) GetUpdatedAt() *string

GetUpdatedAt returns UpdateChannelUpdateChannel.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateChannelUpdateChannel) MarshalJSON added in v0.14.0 

func (v *UpdateChannelUpdateChannel) MarshalJSON() ([]byte, error)

func (*UpdateChannelUpdateChannel) UnmarshalJSON added in v0.14.0 

func (v *UpdateChannelUpdateChannel) UnmarshalJSON(b []byte) error

type UpdateEdgeResponse 

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

UpdateEdgeResponse is returned by UpdateEdge on success.

func UpdateEdge 

func UpdateEdge(
	ctx_ context.Context,
	client_ graphql.Client,
	edgeId string,
	name *string,
	loc *string,
	description *string,
	isRunnable *bool,
	priority *int,
	condition *json.RawMessage,
	data *json.RawMessage,
) (data_ *UpdateEdgeResponse, err_ error)

Omitted = preserve, explicit null = clear (condition/data) or unset (priority). Flags the user didn't pass must not reach the wire.

func (*UpdateEdgeResponse) GetUpdateEdge 

func (v *UpdateEdgeResponse) GetUpdateEdge() *UpdateEdgeUpdateEdge

GetUpdateEdge returns UpdateEdgeResponse.UpdateEdge, and is useful for accessing the field via an interface.

type UpdateEdgeUpdateEdge 

type UpdateEdgeUpdateEdge struct {
	Id string `json:"id"`
	// Free-form relationship name (e.g. imports, depends_on). Optional since
	// spec 037 — loc is the identity. (Was the required 'label'.)
	Name *string `json:"name"`
	// Colon-delimited path within the (source node's) memory — the edge's
	// identity and the suffix of its URN hrn:edge:<root>:<memory>:<loc>.
	Loc string `json:"loc"`
	// If true, this edge can be executed/run (task automation, conversation
	// transitions). Mirrors Node.isRunnable.
	IsRunnable *bool `json:"isRunnable"`
	// Resolution-order hook (lower = earlier; default 0). When two edges
	// share a priority, fall back to insertion order.
	Priority int `json:"priority"`
	// The source node. NULLABLE (#781): null when the caller cannot read the source node's memory — a cross-memory edge (e.g. reached via incomingEdges) must not expose an endpoint in a memory the caller can't read. For a same-memory edge the caller can already see, this is always present.
	Source *UpdateEdgeUpdateEdgeSourceNode `json:"source"`
	// The target node. NULLABLE (#781): null when the caller cannot read the target node's memory (a cross-memory edge's far endpoint). For a same-memory edge, always present.
	Target *UpdateEdgeUpdateEdgeTargetNode `json:"target"`
}

UpdateEdgeUpdateEdge includes the requested fields of the GraphQL type Edge.

func (*UpdateEdgeUpdateEdge) GetId 

func (v *UpdateEdgeUpdateEdge) GetId() string

GetId returns UpdateEdgeUpdateEdge.Id, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdge) GetIsRunnable added in v0.3.0 

func (v *UpdateEdgeUpdateEdge) GetIsRunnable() *bool

GetIsRunnable returns UpdateEdgeUpdateEdge.IsRunnable, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdge) GetLoc added in v0.3.0 

func (v *UpdateEdgeUpdateEdge) GetLoc() string

GetLoc returns UpdateEdgeUpdateEdge.Loc, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdge) GetName added in v0.3.0 

func (v *UpdateEdgeUpdateEdge) GetName() *string

GetName returns UpdateEdgeUpdateEdge.Name, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdge) GetPriority 

func (v *UpdateEdgeUpdateEdge) GetPriority() int

GetPriority returns UpdateEdgeUpdateEdge.Priority, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdge) GetSource 

func (v *UpdateEdgeUpdateEdge) GetSource() *UpdateEdgeUpdateEdgeSourceNode

GetSource returns UpdateEdgeUpdateEdge.Source, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdge) GetTarget 

func (v *UpdateEdgeUpdateEdge) GetTarget() *UpdateEdgeUpdateEdgeTargetNode

GetTarget returns UpdateEdgeUpdateEdge.Target, and is useful for accessing the field via an interface.

type UpdateEdgeUpdateEdgeSourceNode 

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

UpdateEdgeUpdateEdgeSourceNode includes the requested fields of the GraphQL type Node.

func (*UpdateEdgeUpdateEdgeSourceNode) GetId 

func (v *UpdateEdgeUpdateEdgeSourceNode) GetId() string

GetId returns UpdateEdgeUpdateEdgeSourceNode.Id, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdgeSourceNode) GetLoc 

func (v *UpdateEdgeUpdateEdgeSourceNode) GetLoc() string

GetLoc returns UpdateEdgeUpdateEdgeSourceNode.Loc, and is useful for accessing the field via an interface.

type UpdateEdgeUpdateEdgeTargetNode 

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

UpdateEdgeUpdateEdgeTargetNode includes the requested fields of the GraphQL type Node.

func (*UpdateEdgeUpdateEdgeTargetNode) GetId 

func (v *UpdateEdgeUpdateEdgeTargetNode) GetId() string

GetId returns UpdateEdgeUpdateEdgeTargetNode.Id, and is useful for accessing the field via an interface.

func (*UpdateEdgeUpdateEdgeTargetNode) GetLoc 

func (v *UpdateEdgeUpdateEdgeTargetNode) GetLoc() string

GetLoc returns UpdateEdgeUpdateEdgeTargetNode.Loc, and is useful for accessing the field via an interface.

type UpdateMcpServerResponse added in v0.7.0 

type UpdateMcpServerResponse struct {
	// Update a registered MCP server (org ADMIN/OWNER). The slug is
	// immutable — flow nodes reference it in data.tools names. headers
	// REPLACES the stored object; clearHeaders: true removes it (pass one
	// or the other, not both).
	UpdateMcpServer *UpdateMcpServerUpdateMcpServer `json:"updateMcpServer"`
}

UpdateMcpServerResponse is returned by UpdateMcpServer on success.

func UpdateMcpServer added in v0.7.0 

func UpdateMcpServer(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	name *string,
	url *string,
	headers *json.RawMessage,
	clearHeaders *bool,
	toolAllowlist *[]string,
	enabled *bool,
) (data_ *UpdateMcpServerResponse, err_ error)

slug is immutable. headers REPLACES the stored object; clearHeaders removes it (pass one or the other, never both).

func (*UpdateMcpServerResponse) GetUpdateMcpServer added in v0.7.0 

func (v *UpdateMcpServerResponse) GetUpdateMcpServer() *UpdateMcpServerUpdateMcpServer

GetUpdateMcpServer returns UpdateMcpServerResponse.UpdateMcpServer, and is useful for accessing the field via an interface.

type UpdateMcpServerUpdateMcpServer added in v0.7.0 

type UpdateMcpServerUpdateMcpServer struct {
	McpServerFields `json:"-"`
}

UpdateMcpServerUpdateMcpServer includes the requested fields of the GraphQL type McpServer. The GraphQL type's documentation follows.

One registered EXTERNAL MCP server (hadrontool-mcp conduit registry). Org-owned. Static auth headers are encrypted at rest and WRITE-ONLY: no field here ever returns them — hasHeaders is all a reader gets. The row grants nothing by itself; every run-time call walks the policy chain as 'tool.mcp__<slug>__<tool>' plus the run's action budget.

func (*UpdateMcpServerUpdateMcpServer) GetCreatedAt added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetCreatedAt() string

GetCreatedAt returns UpdateMcpServerUpdateMcpServer.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetEnabled added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetEnabled() bool

GetEnabled returns UpdateMcpServerUpdateMcpServer.Enabled, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetHasHeaders added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetHasHeaders() bool

GetHasHeaders returns UpdateMcpServerUpdateMcpServer.HasHeaders, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetId added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetId() string

GetId returns UpdateMcpServerUpdateMcpServer.Id, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetName added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetName() string

GetName returns UpdateMcpServerUpdateMcpServer.Name, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetOrganizationId added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetOrganizationId() string

GetOrganizationId returns UpdateMcpServerUpdateMcpServer.OrganizationId, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetSlug added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetSlug() string

GetSlug returns UpdateMcpServerUpdateMcpServer.Slug, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetToolAllowlist added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetToolAllowlist() []string

GetToolAllowlist returns UpdateMcpServerUpdateMcpServer.ToolAllowlist, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetUpdatedAt added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetUpdatedAt() string

GetUpdatedAt returns UpdateMcpServerUpdateMcpServer.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) GetUrl added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) GetUrl() string

GetUrl returns UpdateMcpServerUpdateMcpServer.Url, and is useful for accessing the field via an interface.

func (*UpdateMcpServerUpdateMcpServer) MarshalJSON added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) MarshalJSON() ([]byte, error)

func (*UpdateMcpServerUpdateMcpServer) UnmarshalJSON added in v0.7.0 

func (v *UpdateMcpServerUpdateMcpServer) UnmarshalJSON(b []byte) error

type UpdateMemoryConfigTemplateClearingDescriptionResponse added in v0.18.0 

type UpdateMemoryConfigTemplateClearingDescriptionResponse struct {
	// #1325 part (c) — change a template by its id. With expectedRevision, a
	// template changed since you read it is refused CONFLICT
	// (extensions.currentRevision) and nothing is written. A template you may not
	// manage reads as MEMORY_CONFIG_TEMPLATE_NOT_FOUND.
	UpdateMemoryConfigTemplate *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload `json:"updateMemoryConfigTemplate"`
}

UpdateMemoryConfigTemplateClearingDescriptionResponse is returned by UpdateMemoryConfigTemplateClearingDescription on success.

func UpdateMemoryConfigTemplateClearingDescription added in v0.18.0 

func UpdateMemoryConfigTemplateClearingDescription(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	expectedRevision int,
	name *string,
	required *bool,
	rules []*CreateNodeRoleRuleInput,
) (data_ *UpdateMemoryConfigTemplateClearingDescriptionResponse, err_ error)

The same update when it also CLEARS the description: the server clears it only on an explicit null, which a genqlient pointer cannot send, so the null is a literal and every other field rides as a variable in the same input (findings:an-explicit-null-needs-a-literal-in-the-document). One update, one revision check.

func (*UpdateMemoryConfigTemplateClearingDescriptionResponse) GetUpdateMemoryConfigTemplate added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionResponse) GetUpdateMemoryConfigTemplate() *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload

GetUpdateMemoryConfigTemplate returns UpdateMemoryConfigTemplateClearingDescriptionResponse.UpdateMemoryConfigTemplate, and is useful for accessing the field via an interface.

type UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload added in v0.18.0 

type UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload struct {
	Template *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate `json:"template"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning `json:"warnings"`
}

UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload includes the requested fields of the GraphQL type MemoryConfigTemplatePayload.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetTemplate added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetTemplate() *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate

GetTemplate returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload.Template, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetWarnings added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetWarnings() []*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning

GetWarnings returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayload.Warnings, and is useful for accessing the field via an interface.

type UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate added in v0.18.0 

type UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate struct {
	MemoryConfigTemplateFields `json:"-"`
}

UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate includes the requested fields of the GraphQL type MemoryConfigTemplate. The GraphQL type's documentation follows.

#1325 part (c) — a reusable rulebook with exactly one owner, COPIED into a memory's config when applied (never live-linked). Read and managed only by its owner's managers: a platform admin (server), an org ADMIN/OWNER (organization), the user themselves (user), the App's owner or org ADMIN/OWNER (App). For anyone else it does not exist.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedAt added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedAt() string

GetCreatedAt returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedBy added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedBy() *string

GetCreatedBy returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.CreatedBy, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetDescription added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetDescription() *string

GetDescription returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Description, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetId added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetId() string

GetId returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Id, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetName added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetName() string

GetName returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Name, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerId added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerId() *string

GetOwnerId returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.OwnerId, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerType added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerType() MemoryConfigTemplateOwnerType

GetOwnerType returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.OwnerType, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRequired added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRequired() bool

GetRequired returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Required, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRevision added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRevision() int

GetRevision returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Revision, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRules added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRules() []*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule

GetRules returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Rules, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedAt added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedAt() *string

GetUpdatedAt returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedBy added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedBy() *string

GetUpdatedBy returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.UpdatedBy, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) MarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) MarshalJSON() ([]byte, error)

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) UnmarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) UnmarshalJSON(b []byte) error

type UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning added in v0.18.0 

type UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetCode added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetCode() string

GetCode returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetField added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetField() *string

GetField returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetRole added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetRole() string

GetRole returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskState added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskUrn added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) MarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) UnmarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateClearingDescriptionUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type UpdateMemoryConfigTemplateInput added in v0.18.0 

type UpdateMemoryConfigTemplateInput struct {
	Description *string                    `json:"description,omitempty"`
	Name        *string                    `json:"name,omitempty"`
	Required    *bool                      `json:"required,omitempty"`
	Rules       []*CreateNodeRoleRuleInput `json:"rules"`
}

#1325 part (c) — change a template. An omitted field is unchanged; description null clears it. `rules`, when given, REPLACES the template's rules in one transaction.

func (*UpdateMemoryConfigTemplateInput) GetDescription added in v0.18.0 

func (v *UpdateMemoryConfigTemplateInput) GetDescription() *string

GetDescription returns UpdateMemoryConfigTemplateInput.Description, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateInput) GetName added in v0.18.0 

func (v *UpdateMemoryConfigTemplateInput) GetName() *string

GetName returns UpdateMemoryConfigTemplateInput.Name, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateInput) GetRequired added in v0.18.0 

func (v *UpdateMemoryConfigTemplateInput) GetRequired() *bool

GetRequired returns UpdateMemoryConfigTemplateInput.Required, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateInput) GetRules added in v0.18.0 

func (v *UpdateMemoryConfigTemplateInput) GetRules() []*CreateNodeRoleRuleInput

GetRules returns UpdateMemoryConfigTemplateInput.Rules, and is useful for accessing the field via an interface.

type UpdateMemoryConfigTemplateResponse added in v0.18.0 

type UpdateMemoryConfigTemplateResponse struct {
	// #1325 part (c) — change a template by its id. With expectedRevision, a
	// template changed since you read it is refused CONFLICT
	// (extensions.currentRevision) and nothing is written. A template you may not
	// manage reads as MEMORY_CONFIG_TEMPLATE_NOT_FOUND.
	UpdateMemoryConfigTemplate *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload `json:"updateMemoryConfigTemplate"`
}

UpdateMemoryConfigTemplateResponse is returned by UpdateMemoryConfigTemplate on success.

func UpdateMemoryConfigTemplate added in v0.18.0 

func UpdateMemoryConfigTemplate(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	input *UpdateMemoryConfigTemplateInput,
	expectedRevision int,
) (data_ *UpdateMemoryConfigTemplateResponse, err_ error)

Omitted = unchanged; `rules`, when given, REPLACES the template's rules in one transaction. `rules` deliberately has NO omitempty: omitempty drops an EMPTY slice as well as a nil one, so `"rules": []` ("remove every rule") would be silently dropped and the rules kept. The server reads null exactly like omitted (`input.rules != null`), so a nil slice sent as null is unchanged, and this input exists on no server that lacks the field. expectedRevision is ALWAYS sent: the revision the caller's FILE was derived from, so a stale file is refused (CONFLICT), never applied. use_struct_references (genqlient.yaml) makes genqlient ADD omitempty to a struct-typed list by default, so "no omitempty" has to be said explicitly.

func (*UpdateMemoryConfigTemplateResponse) GetUpdateMemoryConfigTemplate added in v0.18.0 

func (v *UpdateMemoryConfigTemplateResponse) GetUpdateMemoryConfigTemplate() *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload

GetUpdateMemoryConfigTemplate returns UpdateMemoryConfigTemplateResponse.UpdateMemoryConfigTemplate, and is useful for accessing the field via an interface.

type UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload added in v0.18.0 

type UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload struct {
	Template *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate `json:"template"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning `json:"warnings"`
}

UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload includes the requested fields of the GraphQL type MemoryConfigTemplatePayload.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetTemplate added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetTemplate() *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate

GetTemplate returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload.Template, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetWarnings added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload) GetWarnings() []*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning

GetWarnings returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayload.Warnings, and is useful for accessing the field via an interface.

type UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate added in v0.18.0 

type UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate struct {
	MemoryConfigTemplateFields `json:"-"`
}

UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate includes the requested fields of the GraphQL type MemoryConfigTemplate. The GraphQL type's documentation follows.

#1325 part (c) — a reusable rulebook with exactly one owner, COPIED into a memory's config when applied (never live-linked). Read and managed only by its owner's managers: a platform admin (server), an org ADMIN/OWNER (organization), the user themselves (user), the App's owner or org ADMIN/OWNER (App). For anyone else it does not exist.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedAt added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedAt() string

GetCreatedAt returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedBy added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetCreatedBy() *string

GetCreatedBy returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.CreatedBy, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetDescription added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetDescription() *string

GetDescription returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Description, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetId added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetId() string

GetId returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Id, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetName added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetName() string

GetName returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Name, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerId added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerId() *string

GetOwnerId returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.OwnerId, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerType added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetOwnerType() MemoryConfigTemplateOwnerType

GetOwnerType returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.OwnerType, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRequired added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRequired() bool

GetRequired returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Required, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRevision added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRevision() int

GetRevision returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Revision, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRules added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetRules() []*MemoryConfigTemplateFieldsRulesMemoryConfigTemplateRule

GetRules returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.Rules, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedAt added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedAt() *string

GetUpdatedAt returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedBy added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) GetUpdatedBy() *string

GetUpdatedBy returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate.UpdatedBy, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) MarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) MarshalJSON() ([]byte, error)

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) UnmarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadTemplateMemoryConfigTemplate) UnmarshalJSON(b []byte) error

type UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning added in v0.18.0 

type UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetCode added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetCode() string

GetCode returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetField added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetField() *string

GetField returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetRole added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetRole() string

GetRole returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskState added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskUrn added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) MarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) UnmarshalJSON added in v0.18.0 

func (v *UpdateMemoryConfigTemplateUpdateMemoryConfigTemplateMemoryConfigTemplatePayloadWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type UpdateMemoryMemberRoleResponse added in v0.3.0 

type UpdateMemoryMemberRoleResponse struct {
	// 023-app-shape US4 — change the role on an existing team member.
	// Throws MemoryMemberNotFoundError when the row doesn't exist;
	// use addMemoryMember to upsert. Throws LastOwnerProtectedError
	// (FR-038) when demoting the sole remaining owner.
	//
	// Caller-authority rule matches addMemoryMember.
	//
	// Error codes (extensions.code, Error.name style):
	// - UNAUTHENTICATED — no logged-in user in context.
	// - FORBIDDEN — caller is not an owner of a live group memory.
	// - MemoryNotFoundForMemberError — memory absent or soft-deleted
	// (only reachable from non-GraphQL callers in v1 — the guard
	// short-circuits to FORBIDDEN first).
	// - InvalidMemoryClassForMemberError — memory is not group-class
	// (same; guard short-circuits to FORBIDDEN first).
	// - MemoryMemberNotFoundError — no row at (memoryId, userId).
	// - LastOwnerProtectedError (FR-038) — would demote the sole owner.
	UpdateMemoryMemberRole *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload `json:"updateMemoryMemberRole"`
}

UpdateMemoryMemberRoleResponse is returned by UpdateMemoryMemberRole on success.

func UpdateMemoryMemberRole added in v0.3.0 

func UpdateMemoryMemberRole(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	userRef string,
	role MemoryMemberRole,
) (data_ *UpdateMemoryMemberRoleResponse, err_ error)

func (*UpdateMemoryMemberRoleResponse) GetUpdateMemoryMemberRole added in v0.3.0 

func (v *UpdateMemoryMemberRoleResponse) GetUpdateMemoryMemberRole() *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload

GetUpdateMemoryMemberRole returns UpdateMemoryMemberRoleResponse.UpdateMemoryMemberRole, and is useful for accessing the field via an interface.

type UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload added in v0.3.0 

type UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload struct {
	MemoryMember *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember `json:"memoryMember"`
}

UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload includes the requested fields of the GraphQL type UpdateMemoryMemberRolePayload.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload) GetMemoryMember added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload) GetMemoryMember() *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember

GetMemoryMember returns UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayload.MemoryMember, and is useful for accessing the field via an interface.

type UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember added in v0.3.0 

type UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember struct {
	Role MemoryMemberRole                                                                           `json:"role"`
	User *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser `json:"user"`
}

UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember includes the requested fields of the GraphQL type MemoryMember. The GraphQL type's documentation follows.

023-app-shape US4: symmetric team-membership row for group-class memory. The "Company Brain" model — multiple users collaboratively read/write a shared memory, governance by role, no single owner on the Memory itself.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember) GetRole added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember) GetRole() MemoryMemberRole

GetRole returns UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember.Role, and is useful for accessing the field via an interface.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember) GetUser added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember) GetUser() *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser

GetUser returns UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMember.User, and is useful for accessing the field via an interface.

type UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser added in v0.3.0 

type UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser struct {
	MemUserFields `json:"-"`
}

UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser includes the requested fields of the GraphQL type User.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetEmail added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetEmail() *string

GetEmail returns UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser.Email, and is useful for accessing the field via an interface.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetHandle added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetHandle() *string

GetHandle returns UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser.Handle, and is useful for accessing the field via an interface.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetId added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetId() string

GetId returns UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser.Id, and is useful for accessing the field via an interface.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetName added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) GetName() *string

GetName returns UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser.Name, and is useful for accessing the field via an interface.

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) MarshalJSON added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) MarshalJSON() ([]byte, error)

func (*UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) UnmarshalJSON added in v0.3.0 

func (v *UpdateMemoryMemberRoleUpdateMemoryMemberRoleUpdateMemoryMemberRolePayloadMemoryMemberUser) UnmarshalJSON(b []byte) error

type UpdateMemoryResponse 

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"`
}

UpdateMemoryResponse is returned by UpdateMemory on success.

func UpdateMemory 

func UpdateMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	name *string,
	shortDescription *string,
	description *string,
	tags *[]string,
	visibility *MemoryVisibility,
	data *json.RawMessage,
	urn *string,
	maxRevCount *int,
	schema *json.RawMessage,
) (data_ *UpdateMemoryResponse, err_ error)

Omitted = preserve; flags the user didn't pass must not reach the wire.

func (*UpdateMemoryResponse) GetUpdateMemory 

func (v *UpdateMemoryResponse) GetUpdateMemory() *UpdateMemoryUpdateMemory

GetUpdateMemory returns UpdateMemoryResponse.UpdateMemory, and is useful for accessing the field via an interface.

type UpdateMemoryShareRoleResponse added in v0.3.0 

type UpdateMemoryShareRoleResponse struct {
	// 023-app-shape US3 — change the role on an existing MemoryShare.
	// Throws MemoryShareNotFoundError if the (memoryId, granteeId) row
	// doesn't exist — use createMemoryShare to upsert.
	//
	// Caller-authority rule matches createMemoryShare.
	UpdateMemoryShareRole *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload `json:"updateMemoryShareRole"`
}

UpdateMemoryShareRoleResponse is returned by UpdateMemoryShareRole on success.

func UpdateMemoryShareRole added in v0.3.0 

func UpdateMemoryShareRole(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryId string,
	granteeRef string,
	role MemoryShareRole,
) (data_ *UpdateMemoryShareRoleResponse, err_ error)

func (*UpdateMemoryShareRoleResponse) GetUpdateMemoryShareRole added in v0.3.0 

func (v *UpdateMemoryShareRoleResponse) GetUpdateMemoryShareRole() *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload

GetUpdateMemoryShareRole returns UpdateMemoryShareRoleResponse.UpdateMemoryShareRole, and is useful for accessing the field via an interface.

type UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload added in v0.3.0 

type UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload struct {
	MemoryShare *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare `json:"memoryShare"`
}

UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload includes the requested fields of the GraphQL type UpdateMemoryShareRolePayload.

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload) GetMemoryShare added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload) GetMemoryShare() *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare

GetMemoryShare returns UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayload.MemoryShare, and is useful for accessing the field via an interface.

type UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare added in v0.3.0 

type UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare struct {
	Role MemoryShareRole `json:"role"`
	// The User who was granted access.
	Grantee *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser `json:"grantee"`
}

UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare includes the requested fields of the GraphQL type MemoryShare. The GraphQL type's documentation follows.

023-app-shape US3: asymmetric cross-user grant on a personal-class Memory. The principal (memory.userId) grants a grantee read/write access. Used for per-pairing isolation patterns (e.g., Alice's personal Memory paired-with-Mentor-A is distinct from her paired-with-Mentor-B Memory, each with its own MemoryShare).

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare) GetGrantee added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare) GetGrantee() *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser

GetGrantee returns UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare.Grantee, and is useful for accessing the field via an interface.

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare) GetRole added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare) GetRole() MemoryShareRole

GetRole returns UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShare.Role, and is useful for accessing the field via an interface.

type UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser added in v0.3.0 

type UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser struct {
	MemUserFields `json:"-"`
}

UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser includes the requested fields of the GraphQL type User.

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetEmail added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetEmail() *string

GetEmail returns UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser.Email, and is useful for accessing the field via an interface.

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetHandle added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetHandle() *string

GetHandle returns UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser.Handle, and is useful for accessing the field via an interface.

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetId added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetId() string

GetId returns UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser.Id, and is useful for accessing the field via an interface.

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetName added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) GetName() *string

GetName returns UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser.Name, and is useful for accessing the field via an interface.

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) MarshalJSON added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) MarshalJSON() ([]byte, error)

func (*UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) UnmarshalJSON added in v0.3.0 

func (v *UpdateMemoryShareRoleUpdateMemoryShareRoleUpdateMemoryShareRolePayloadMemoryShareGranteeUser) UnmarshalJSON(b []byte) error

type UpdateMemorySubscriptionResponse added in v0.7.0 

type UpdateMemorySubscriptionResponse struct {
	// Update a cross-org Memory subscription.
	//
	// Accepts the entity's ID or URN.
	UpdateMemorySubscription *UpdateMemorySubscriptionUpdateMemorySubscription `json:"updateMemorySubscription"`
}

UpdateMemorySubscriptionResponse is returned by UpdateMemorySubscription on success.

func UpdateMemorySubscription added in v0.7.0 

func UpdateMemorySubscription(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	orgRef string,
	role Role,
) (data_ *UpdateMemorySubscriptionResponse, err_ error)

func (*UpdateMemorySubscriptionResponse) GetUpdateMemorySubscription added in v0.7.0 

func (v *UpdateMemorySubscriptionResponse) GetUpdateMemorySubscription() *UpdateMemorySubscriptionUpdateMemorySubscription

GetUpdateMemorySubscription returns UpdateMemorySubscriptionResponse.UpdateMemorySubscription, and is useful for accessing the field via an interface.

type UpdateMemorySubscriptionUpdateMemorySubscription added in v0.7.0 

type UpdateMemorySubscriptionUpdateMemorySubscription struct {
	Role      Role `json:"role"`
	Activated bool `json:"activated"`
	// The subscriber Organization when the caller may read it; memory access alone does not authorize it.
	Organization *UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization `json:"organization"`
}

UpdateMemorySubscriptionUpdateMemorySubscription includes the requested fields of the GraphQL type MemorySubscription. The GraphQL type's documentation follows.

An organization's subscription to a memory it does not own.

func (*UpdateMemorySubscriptionUpdateMemorySubscription) GetActivated added in v0.7.0 

func (v *UpdateMemorySubscriptionUpdateMemorySubscription) GetActivated() bool

GetActivated returns UpdateMemorySubscriptionUpdateMemorySubscription.Activated, and is useful for accessing the field via an interface.

func (*UpdateMemorySubscriptionUpdateMemorySubscription) GetOrganization added in v0.7.0 

func (v *UpdateMemorySubscriptionUpdateMemorySubscription) GetOrganization() *UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization

GetOrganization returns UpdateMemorySubscriptionUpdateMemorySubscription.Organization, and is useful for accessing the field via an interface.

func (*UpdateMemorySubscriptionUpdateMemorySubscription) GetRole added in v0.7.0 

func (v *UpdateMemorySubscriptionUpdateMemorySubscription) GetRole() Role

GetRole returns UpdateMemorySubscriptionUpdateMemorySubscription.Role, and is useful for accessing the field via an interface.

type UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization added in v0.7.0 

type UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization struct {
	Id   string `json:"id"`
	Name string `json:"name"`
	Urn  string `json:"urn"`
}

UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization) GetId added in v0.7.0 

func (v *UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization) GetId() string

GetId returns UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization.Id, and is useful for accessing the field via an interface.

func (*UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization) GetName added in v0.7.0 

func (v *UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization) GetName() string

GetName returns UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization.Name, and is useful for accessing the field via an interface.

func (*UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization) GetUrn added in v0.7.0 

func (v *UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization) GetUrn() string

GetUrn returns UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization.Urn, and is useful for accessing the field via an interface.

type UpdateMemoryUpdateMemory 

type UpdateMemoryUpdateMemory struct {
	Id string `json:"id"`
	// The memory's URN, grammar v2 (cor:urn:010:01): hrn:mem:<root>:<slug...>,
	// emitted by safeCanonicalUrn/emitEntityUrnV2 from the stored urn — so a v1
	// double-colon chain, a legacy single-colon row and an already-v2 row all read
	// back identically here. <slug...> is one atom for a migrated memory but still
	// several for a compound pre-Stage-3 per-user one (<root>:<agent>:app-user:<id>).
	//
	// The STORED column is the bare form (<root>:<slug>, no scheme prefix — the
	// chk_memory_urn_not_prefixed guardrail rejects writing a rendered one); this
	// field is the rendered view of it. When emission throws, the stored value is
	// served raw and logged, so a bare, unprefixed value is a possible read.
	Urn              string  `json:"urn"`
	Name             string  `json:"name"`
	ShortDescription *string `json:"shortDescription"`
	// Which memory typology this row belongs to. See MemoryClass for the
	// members — deliberately not restated here, because the count is what
	// went stale: this said "four-way" from 005-agent-subscription until
	// #1232, long after `group` (023) and `private` made it six.
	Class MemoryClass `json:"class"`
	// 035-visibility-enum-cleanup: nullable — set only for knowledge/group.
	Visibility     *MemoryVisibility `json:"visibility"`
	OrganizationId *string           `json:"organizationId"`
	IsEncrypted    bool              `json:"isEncrypted"`
	// #621 — cap on how many NodeRevision rows are kept per node in this memory.
	// On each new revision the oldest overflow is pruned. Default 10; minimum 1.
	MaxRevCount int `json:"maxRevCount"`
	// 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"`
}

UpdateMemoryUpdateMemory includes the requested fields of the GraphQL type Memory. The GraphQL type's documentation follows.

A Hadron memory (git repo + branch settings).

func (*UpdateMemoryUpdateMemory) GetClass 

func (v *UpdateMemoryUpdateMemory) GetClass() MemoryClass

GetClass returns UpdateMemoryUpdateMemory.Class, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetData added in v0.2.0 

func (v *UpdateMemoryUpdateMemory) GetData() *json.RawMessage

GetData returns UpdateMemoryUpdateMemory.Data, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetId 

func (v *UpdateMemoryUpdateMemory) GetId() string

GetId returns UpdateMemoryUpdateMemory.Id, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetIsEncrypted 

func (v *UpdateMemoryUpdateMemory) GetIsEncrypted() bool

GetIsEncrypted returns UpdateMemoryUpdateMemory.IsEncrypted, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetMaxRevCount added in v0.7.0 

func (v *UpdateMemoryUpdateMemory) GetMaxRevCount() int

GetMaxRevCount returns UpdateMemoryUpdateMemory.MaxRevCount, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetName 

func (v *UpdateMemoryUpdateMemory) GetName() string

GetName returns UpdateMemoryUpdateMemory.Name, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetOrganizationId 

func (v *UpdateMemoryUpdateMemory) GetOrganizationId() *string

GetOrganizationId returns UpdateMemoryUpdateMemory.OrganizationId, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetShortDescription 

func (v *UpdateMemoryUpdateMemory) GetShortDescription() *string

GetShortDescription returns UpdateMemoryUpdateMemory.ShortDescription, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetUpdatedAt 

func (v *UpdateMemoryUpdateMemory) GetUpdatedAt() string

GetUpdatedAt returns UpdateMemoryUpdateMemory.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetUrn 

func (v *UpdateMemoryUpdateMemory) GetUrn() string

GetUrn returns UpdateMemoryUpdateMemory.Urn, and is useful for accessing the field via an interface.

func (*UpdateMemoryUpdateMemory) GetVisibility 

func (v *UpdateMemoryUpdateMemory) GetVisibility() *MemoryVisibility

GetVisibility returns UpdateMemoryUpdateMemory.Visibility, and is useful for accessing the field via an interface.

type UpdateMyProfileResponse added in v0.7.0 

type UpdateMyProfileResponse struct {
	UpdateMyProfile *UpdateMyProfileUpdateMyProfileUser `json:"updateMyProfile"`
}

UpdateMyProfileResponse is returned by UpdateMyProfile on success.

func UpdateMyProfile added in v0.7.0 

func UpdateMyProfile(
	ctx_ context.Context,
	client_ graphql.Client,
	name *string,
	email *string,
	handle *string,
) (data_ *UpdateMyProfileResponse, err_ error)

Update the signed-in user's own profile (#56). Only the fields passed are sent (omitempty), so an unset flag leaves that field unchanged.

func (*UpdateMyProfileResponse) GetUpdateMyProfile added in v0.7.0 

func (v *UpdateMyProfileResponse) GetUpdateMyProfile() *UpdateMyProfileUpdateMyProfileUser

GetUpdateMyProfile returns UpdateMyProfileResponse.UpdateMyProfile, and is useful for accessing the field via an interface.

type UpdateMyProfileUpdateMyProfileUser added in v0.7.0 

type UpdateMyProfileUpdateMyProfileUser struct {
	UserFields `json:"-"`
}

UpdateMyProfileUpdateMyProfileUser includes the requested fields of the GraphQL type User.

func (*UpdateMyProfileUpdateMyProfileUser) GetEmail added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetEmail() *string

GetEmail returns UpdateMyProfileUpdateMyProfileUser.Email, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetExternalAppId added in v0.9.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetExternalAppId() *string

GetExternalAppId returns UpdateMyProfileUpdateMyProfileUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetExternalId added in v0.9.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetExternalId() *string

GetExternalId returns UpdateMyProfileUpdateMyProfileUser.ExternalId, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetGithubId added in v0.9.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetGithubId() *int

GetGithubId returns UpdateMyProfileUpdateMyProfileUser.GithubId, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetGithubUsername added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetGithubUsername() *string

GetGithubUsername returns UpdateMyProfileUpdateMyProfileUser.GithubUsername, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetHandle added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetHandle() *string

GetHandle returns UpdateMyProfileUpdateMyProfileUser.Handle, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetId added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetId() string

GetId returns UpdateMyProfileUpdateMyProfileUser.Id, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetIdentityProvider added in v0.9.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetIdentityProvider() *string

GetIdentityProvider returns UpdateMyProfileUpdateMyProfileUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetLinkedAt added in v0.9.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetLinkedAt() *string

GetLinkedAt returns UpdateMyProfileUpdateMyProfileUser.LinkedAt, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetName added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetName() *string

GetName returns UpdateMyProfileUpdateMyProfileUser.Name, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetRoles added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetRoles() []Role

GetRoles returns UpdateMyProfileUpdateMyProfileUser.Roles, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) GetUrn added in v0.14.0 

func (v *UpdateMyProfileUpdateMyProfileUser) GetUrn() *string

GetUrn returns UpdateMyProfileUpdateMyProfileUser.Urn, and is useful for accessing the field via an interface.

func (*UpdateMyProfileUpdateMyProfileUser) MarshalJSON added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) MarshalJSON() ([]byte, error)

func (*UpdateMyProfileUpdateMyProfileUser) UnmarshalJSON added in v0.7.0 

func (v *UpdateMyProfileUpdateMyProfileUser) UnmarshalJSON(b []byte) error

type UpdateNodeDataResponse added in v0.4.0 

type UpdateNodeDataResponse struct {
	// Shallow-merge a JSON patch into a node's 'data' bag. The supplied JSON's
	// top-level keys are written over the node's existing 'data' (the patch
	// wins on key collision); keys the patch doesn't mention are preserved.
	// If the node has no 'data' yet, the supplied JSON becomes its 'data'
	// verbatim. 'data' must be a JSON object (not an array or scalar). 'nodeRef'
	// is a node ID or fully-qualified URN. Honors the same single-write
	// invariants as updateNode (per-memory write auth, encryption, revision
	// history, git mirror). Returns the updated node.
	UpdateNodeData *UpdateNodeDataUpdateNodeDataNode `json:"updateNodeData"`
}

UpdateNodeDataResponse is returned by UpdateNodeData on success.

func UpdateNodeData added in v0.4.0 

func UpdateNodeData(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
	data json.RawMessage,
	reason *string,
) (data_ *UpdateNodeDataResponse, err_ error)

Shallow-merge a JSON patch into a node's `data` bag (the supplied object's top-level keys overwrite existing ones; absent keys are preserved). Unlike UpdateNode's `data`, which replaces the whole bag, this is a merge — the server rejects a non-object patch with BAD_USER_INPUT. Backs the `--data-merge`/`--data-merge-file` flags on `hadron node update`.

func (*UpdateNodeDataResponse) GetUpdateNodeData added in v0.4.0 

func (v *UpdateNodeDataResponse) GetUpdateNodeData() *UpdateNodeDataUpdateNodeDataNode

GetUpdateNodeData returns UpdateNodeDataResponse.UpdateNodeData, and is useful for accessing the field via an interface.

type UpdateNodeDataUpdateNodeDataNode added in v0.4.0 

type UpdateNodeDataUpdateNodeDataNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

UpdateNodeDataUpdateNodeDataNode includes the requested fields of the GraphQL type Node.

func (*UpdateNodeDataUpdateNodeDataNode) GetId added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetId() string

GetId returns UpdateNodeDataUpdateNodeDataNode.Id, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetIsRunnable added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetIsRunnable() *bool

GetIsRunnable returns UpdateNodeDataUpdateNodeDataNode.IsRunnable, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetLoc added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetLoc() string

GetLoc returns UpdateNodeDataUpdateNodeDataNode.Loc, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetMemoryId added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetMemoryId() string

GetMemoryId returns UpdateNodeDataUpdateNodeDataNode.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetName added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetName() string

GetName returns UpdateNodeDataUpdateNodeDataNode.Name, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetNodeType added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetNodeType() string

GetNodeType returns UpdateNodeDataUpdateNodeDataNode.NodeType, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetRole added in v0.15.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetRole() *string

GetRole returns UpdateNodeDataUpdateNodeDataNode.Role, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetTags added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetTags() []string

GetTags returns UpdateNodeDataUpdateNodeDataNode.Tags, and is useful for accessing the field via an interface.

func (*UpdateNodeDataUpdateNodeDataNode) GetUpdatedAt added in v0.4.0 

func (v *UpdateNodeDataUpdateNodeDataNode) GetUpdatedAt() string

GetUpdatedAt returns UpdateNodeDataUpdateNodeDataNode.UpdatedAt, and is useful for accessing the field via an interface.

type UpdateNodeInput added in v0.5.1 

type UpdateNodeInput struct {
	// Paragraph-length summary of this node — see Node.abstract for the surfacing contract. 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"`
	// MIME type of content (#476/#488, spec cor:cnv:010:01): 'text/markdown' (default) stores as-is; 'text/html' converts captured DOM to Markdown; 'application/pdf' extracts a PDF's text layer to Markdown (send 'content' as raw base64 — a PDF is binary; scanned/image-only PDFs error). The conversion runs before storage and fills properties.title from the extracted title when not supplied. Consumed at write time — never persisted. Any other value is rejected.
	ContentType *string          `json:"contentType,omitempty"`
	Data        *json.RawMessage `json:"data,omitempty"`
	Description *string          `json:"description,omitempty"`
	// Replace all outgoing edges when provided (omit to leave edges unchanged)
	Edges []*NodeEdgeInput `json:"edges,omitempty"`
	// Optional optimistic-concurrency precondition (#937). When supplied, the
	// update is applied only while the node's current live revision still equals
	// this positive integer. A mismatch refuses atomically with
	// NODE_WRITE_CONFLICT; omitting it or passing null preserves last-write-wins
	// compatibility.
	// Read the baseline from Node.revision.
	ExpectedRevision *int `json:"expectedRevision,omitempty"`
	// The node to change: PK (CUID / 32-char hex) or fully-qualified node URN (hrn:node:<root>:<memory>:<loc>). XOR with memoryId+loc.
	Id *string `json:"id,omitempty"`
	// Whether this node can be run as a task by hadron_run_task (cor:api:060). Omit to preserve.
	IsRunnable *bool   `json:"isRunnable,omitempty"`
	LlmModel   *string `json:"llmModel,omitempty"`
	// Selector, with 'memoryId': the target's current loc. Not writable here — moveNode relocates.
	Loc *string `json:"loc,omitempty"`
	// Selector, with 'loc': the target's memory (ID or fully-qualified URN). XOR with 'id'.
	MemoryId *string `json:"memoryId,omitempty"`
	// Omit to preserve (D4).
	Name     *string `json:"name,omitempty"`
	NodeType *string `json:"nodeType,omitempty"`
	// #725 — collection discriminator (e.g. "competitor"). Omit to preserve; null to clear.
	ObjectType *string          `json:"objectType,omitempty"`
	OwnerRepo  *string          `json:"ownerRepo,omitempty"`
	Properties *json.RawMessage `json:"properties,omitempty"`
	// Why this change was made — recorded on the revision-history snapshot
	// (NodeRevision.revLabel, #620; historically it squatted in editedBy),
	// mirroring hadron_update_node's reason arg so CLI and MCP edits leave
	// equally-traceable history.
	Reason *string `json:"reason,omitempty"`
	// #1201 — what this node is FOR (open string). NOT 'nodeType' and NOT
	// 'objectType' — see Node.role. Omit to preserve; null to clear. A GOVERNED
	// value requires that kind's own door, and so does editing a node that
	// ALREADY carries one: the gate reads the resulting state, not the change.
	Role *string `json:"role,omitempty"`
	Seq  *int    `json:"seq,omitempty"`
	// Omit to preserve existing tags (issue #235); supply to replace the set.
	Tags []string `json:"tags,omitempty"`
}

Input for updateNode. Identify the target by 'id' (PK or fully-qualified node URN) XOR ('memoryId' + 'loc') — both selectors, or neither, is an error (spec 039 Phase 0 D2). updateNode never creates and never moves (D3). Every content field is optional: omitted = preserved (D4).

func (*UpdateNodeInput) GetAbstract added in v0.5.1 

func (v *UpdateNodeInput) GetAbstract() *string

GetAbstract returns UpdateNodeInput.Abstract, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetAiAgent added in v0.5.1 

func (v *UpdateNodeInput) GetAiAgent() *string

GetAiAgent returns UpdateNodeInput.AiAgent, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetAlias added in v0.5.1 

func (v *UpdateNodeInput) GetAlias() *string

GetAlias returns UpdateNodeInput.Alias, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetContent added in v0.5.1 

func (v *UpdateNodeInput) GetContent() *string

GetContent returns UpdateNodeInput.Content, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetContentType added in v0.6.0 

func (v *UpdateNodeInput) GetContentType() *string

GetContentType returns UpdateNodeInput.ContentType, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetData added in v0.5.1 

func (v *UpdateNodeInput) GetData() *json.RawMessage

GetData returns UpdateNodeInput.Data, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetDescription added in v0.5.1 

func (v *UpdateNodeInput) GetDescription() *string

GetDescription returns UpdateNodeInput.Description, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetEdges added in v0.5.1 

func (v *UpdateNodeInput) GetEdges() []*NodeEdgeInput

GetEdges returns UpdateNodeInput.Edges, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetExpectedRevision added in v0.18.0 

func (v *UpdateNodeInput) GetExpectedRevision() *int

GetExpectedRevision returns UpdateNodeInput.ExpectedRevision, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetId added in v0.5.1 

func (v *UpdateNodeInput) GetId() *string

GetId returns UpdateNodeInput.Id, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetIsRunnable added in v0.5.1 

func (v *UpdateNodeInput) GetIsRunnable() *bool

GetIsRunnable returns UpdateNodeInput.IsRunnable, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetLlmModel added in v0.5.1 

func (v *UpdateNodeInput) GetLlmModel() *string

GetLlmModel returns UpdateNodeInput.LlmModel, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetLoc added in v0.5.1 

func (v *UpdateNodeInput) GetLoc() *string

GetLoc returns UpdateNodeInput.Loc, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetMemoryId added in v0.5.1 

func (v *UpdateNodeInput) GetMemoryId() *string

GetMemoryId returns UpdateNodeInput.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetName added in v0.5.1 

func (v *UpdateNodeInput) GetName() *string

GetName returns UpdateNodeInput.Name, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetNodeType added in v0.5.1 

func (v *UpdateNodeInput) GetNodeType() *string

GetNodeType returns UpdateNodeInput.NodeType, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetObjectType added in v0.8.0 

func (v *UpdateNodeInput) GetObjectType() *string

GetObjectType returns UpdateNodeInput.ObjectType, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetOwnerRepo added in v0.5.1 

func (v *UpdateNodeInput) GetOwnerRepo() *string

GetOwnerRepo returns UpdateNodeInput.OwnerRepo, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetProperties added in v0.5.1 

func (v *UpdateNodeInput) GetProperties() *json.RawMessage

GetProperties returns UpdateNodeInput.Properties, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetReason added in v0.5.1 

func (v *UpdateNodeInput) GetReason() *string

GetReason returns UpdateNodeInput.Reason, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetRole added in v0.14.0 

func (v *UpdateNodeInput) GetRole() *string

GetRole returns UpdateNodeInput.Role, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetSeq added in v0.5.1 

func (v *UpdateNodeInput) GetSeq() *int

GetSeq returns UpdateNodeInput.Seq, and is useful for accessing the field via an interface.

func (*UpdateNodeInput) GetTags added in v0.5.1 

func (v *UpdateNodeInput) GetTags() []string

GetTags returns UpdateNodeInput.Tags, and is useful for accessing the field via an interface.

type UpdateNodeResponse added in v0.5.1 

type UpdateNodeResponse struct {
	// Update an existing node. Identify it by 'id' (PK or fully-qualified node
	// URN) XOR the ('memoryId', 'loc') combo — supplying both selectors, or
	// neither, is an error (D2). Rejects with NODE_NOT_FOUND when the target
	// does not exist; updateNode never creates and never moves (relocation is
	// moveNode's job, D3). Every content field is optional — omitted fields are
	// preserved ('name' included, D4; 'abstract' keeps its omit/null/string
	// contract; omitted 'tags' are preserved, issue #235).
	UpdateNode *UpdateNodeUpdateNode `json:"updateNode"`
}

UpdateNodeResponse is returned by UpdateNode on success.

func UpdateNode added in v0.5.1 

func UpdateNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *UpdateNodeInput,
) (data_ *UpdateNodeResponse, err_ error)

Update-only node write (spec 039 Phase 0). Target by `id` (PK or fully-qualified node URN) XOR (`memoryId` + `loc`) — both or neither is BAD_USER_INPUT; a miss is extensions.code NODE_NOT_FOUND (updateNode never creates). Every content field is optional: the server reads an *omitted* field as "preserve" (name and tags included) and an explicit null as "clear" — nil pointers must therefore be omitted from the wire, not serialized as null.

func (*UpdateNodeResponse) GetUpdateNode added in v0.5.1 

func (v *UpdateNodeResponse) GetUpdateNode() *UpdateNodeUpdateNode

GetUpdateNode returns UpdateNodeResponse.UpdateNode, and is useful for accessing the field via an interface.

type UpdateNodeRevisionResponse added in v0.7.0 

type UpdateNodeRevisionResponse struct {
	// Set or clear the user-facing label on a revision snapshot (#620,
	// NodeRevision.revLabel, 500-char cap). Omit revLabel to preserve; pass
	// null to clear. Auth: the node's memory write access (as
	// deleteNodeRevision) PLUS the nodeRevision query's read gates — it returns
	// the full snapshot, so a soft-deleted node or a snapshot captured in an
	// unreadable memory answers the same NOT_FOUND as an unknown id.
	UpdateNodeRevision *UpdateNodeRevisionUpdateNodeRevision `json:"updateNodeRevision"`
}

UpdateNodeRevisionResponse is returned by UpdateNodeRevision on success.

func UpdateNodeRevision added in v0.7.0 

func UpdateNodeRevision(
	ctx_ context.Context,
	client_ graphql.Client,
	revisionId string,
	revLabel *string,
) (data_ *UpdateNodeRevisionResponse, err_ error)

Set a revision's user-facing label (#620, 500-char cap). Returns the full snapshot (and enforces the same read gates as nodeRevision).

func (*UpdateNodeRevisionResponse) GetUpdateNodeRevision added in v0.7.0 

func (v *UpdateNodeRevisionResponse) GetUpdateNodeRevision() *UpdateNodeRevisionUpdateNodeRevision

GetUpdateNodeRevision returns UpdateNodeRevisionResponse.UpdateNodeRevision, and is useful for accessing the field via an interface.

type UpdateNodeRevisionUpdateNodeRevision added in v0.7.0 

type UpdateNodeRevisionUpdateNodeRevision struct {
	RevisionFields `json:"-"`
}

UpdateNodeRevisionUpdateNodeRevision includes the requested fields of the GraphQL type NodeRevision.

func (*UpdateNodeRevisionUpdateNodeRevision) GetChanges added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetChanges() []string

GetChanges returns UpdateNodeRevisionUpdateNodeRevision.Changes, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetCreatedAt added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetCreatedAt() string

GetCreatedAt returns UpdateNodeRevisionUpdateNodeRevision.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetDescription added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetDescription() *string

GetDescription returns UpdateNodeRevisionUpdateNodeRevision.Description, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetEditedBy added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetEditedBy() *string

GetEditedBy returns UpdateNodeRevisionUpdateNodeRevision.EditedBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetEditedByInfo added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetEditedByInfo() *string

GetEditedByInfo returns UpdateNodeRevisionUpdateNodeRevision.EditedByInfo, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetEditedByUser added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetEditedByUser() *RevisionFieldsEditedByUserNodeRevisionEditor

GetEditedByUser returns UpdateNodeRevisionUpdateNodeRevision.EditedByUser, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetId added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetId() string

GetId returns UpdateNodeRevisionUpdateNodeRevision.Id, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetLoc added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetLoc() string

GetLoc returns UpdateNodeRevisionUpdateNodeRevision.Loc, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetName added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetName() string

GetName returns UpdateNodeRevisionUpdateNodeRevision.Name, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetNodeId added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetNodeId() string

GetNodeId returns UpdateNodeRevisionUpdateNodeRevision.NodeId, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetRevLabel added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetRevLabel() *string

GetRevLabel returns UpdateNodeRevisionUpdateNodeRevision.RevLabel, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) GetTags added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) GetTags() []string

GetTags returns UpdateNodeRevisionUpdateNodeRevision.Tags, and is useful for accessing the field via an interface.

func (*UpdateNodeRevisionUpdateNodeRevision) MarshalJSON added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) MarshalJSON() ([]byte, error)

func (*UpdateNodeRevisionUpdateNodeRevision) UnmarshalJSON added in v0.7.0 

func (v *UpdateNodeRevisionUpdateNodeRevision) UnmarshalJSON(b []byte) error

type UpdateNodeRoleRuleClearingValidateByResponse added in v0.18.0 

type UpdateNodeRoleRuleClearingValidateByResponse struct {
	// #1325 — change a rule by its id. With expectedRevision, a rule changed since
	// you read it is refused CONFLICT (extensions.currentRevision) and nothing is
	// written; omitted, the last writer wins. A rule you may not manage reads as
	// NOT_FOUND. A LOCKED rule (#1334) is refused with RULE_LOCKED (extensions
	// ruleId, role, sourceTemplateId) for EVERY caller: unlock it first
	// (unlockNodeRoleRule) or re-apply its required template.
	UpdateNodeRoleRule *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload `json:"updateNodeRoleRule"`
}

UpdateNodeRoleRuleClearingValidateByResponse is returned by UpdateNodeRoleRuleClearingValidateBy on success.

func UpdateNodeRoleRuleClearingValidateBy added in v0.18.0 

func UpdateNodeRoleRuleClearingValidateBy(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	expectedRevision int,
	authorTaskRef *string,
	validationTaskRef *string,
	descriptionNodeRef *string,
	strictSubRoles *bool,
	writers *NodeRoleWriters,
	enabled *bool,
) (data_ *UpdateNodeRoleRuleClearingValidateByResponse, err_ error)

The same update when it also CLEARS validateBy. The server clears validateBy only on an explicit `null`, which a genqlient pointer field cannot send (omitempty drops nil; without omitempty every OTHER update would clear it). So the null is a literal in the document, and every other field rides as a variable in the same input object.

An omitempty variable left unset is MISSING, and GraphQL coerces an input field whose variable is missing to ABSENT, not null (graphql-js 16, measured for cli#716): `{validateBy: null, writers: $writers}` with no $writers sends exactly {validateBy: null}. So this is still ONE update under ONE revision check — never a clear followed by a second save (team chat #1888).

func (*UpdateNodeRoleRuleClearingValidateByResponse) GetUpdateNodeRoleRule added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByResponse) GetUpdateNodeRoleRule() *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload

GetUpdateNodeRoleRule returns UpdateNodeRoleRuleClearingValidateByResponse.UpdateNodeRoleRule, and is useful for accessing the field via an interface.

type UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload added in v0.18.0 

type UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload struct {
	Rule *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule `json:"rule"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning `json:"warnings"`
}

UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload includes the requested fields of the GraphQL type NodeRoleRulePayload.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload) GetRule added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload) GetRule() *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule

GetRule returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload.Rule, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload) GetWarnings added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload) GetWarnings() []*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning

GetWarnings returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayload.Warnings, and is useful for accessing the field via an interface.

type UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule added in v0.18.0 

type UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule struct {
	NodeRoleRuleFields `json:"-"`
}

UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule includes the requested fields of the GraphQL type NodeRoleRule. The GraphQL type's documentation follows.

#1325 — one node-role rule. Task and description references are stored by node id (they survive moves) and returned as a URN and an id, each with its state. Both are given only when the state is OK; see NodeRoleRuleRefState.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask() *string

GetAuthorTask returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTask, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId() *string

GetAuthorTaskId returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt() string

GetCreatedAt returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy() *string

GetCreatedBy returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode() *string

GetDescriptionNode returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNode, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId() *string

GetDescriptionNodeId returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled() bool

GetEnabled returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Enabled, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId() string

GetId returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Id, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked() bool

GetLocked returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Locked, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision() int

GetRevision returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Revision, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole() string

GetRole returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Role, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate() *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate

GetSourceTemplate returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplate, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId() *string

GetSourceTemplateId returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplateId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles() bool

GetStrictSubRoles returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.StrictSubRoles, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt() *string

GetUpdatedAt returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy() *string

GetUpdatedBy returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy() *ContentValidator

GetValidateBy returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidateBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask() *string

GetValidationTask returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTask, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId() *string

GetValidationTaskId returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters() NodeRoleWriters

GetWriters returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Writers, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON() ([]byte, error)

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON(b []byte) error

type UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning added in v0.18.0 

type UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode() string

GetCode returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField() *string

GetField returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole() string

GetRole returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleClearingValidateByUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type UpdateNodeRoleRuleInput added in v0.18.0 

type UpdateNodeRoleRuleInput struct {
	AuthorTaskRef      *string           `json:"authorTaskRef,omitempty"`
	DescriptionNodeRef *string           `json:"descriptionNodeRef,omitempty"`
	Enabled            *bool             `json:"enabled,omitempty"`
	StrictSubRoles     *bool             `json:"strictSubRoles,omitempty"`
	ValidateBy         *ContentValidator `json:"validateBy,omitempty"`
	ValidationTaskRef  *string           `json:"validationTaskRef,omitempty"`
	Writers            *NodeRoleWriters  `json:"writers,omitempty"`
}

#1325 — change a rule. An omitted field is unchanged. A reference given as null or an empty string CLEARS it; validateBy null clears it. The role itself is the rule's identity and cannot be changed: delete and re-create instead.

func (*UpdateNodeRoleRuleInput) GetAuthorTaskRef added in v0.18.0 

func (v *UpdateNodeRoleRuleInput) GetAuthorTaskRef() *string

GetAuthorTaskRef returns UpdateNodeRoleRuleInput.AuthorTaskRef, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleInput) GetDescriptionNodeRef added in v0.18.0 

func (v *UpdateNodeRoleRuleInput) GetDescriptionNodeRef() *string

GetDescriptionNodeRef returns UpdateNodeRoleRuleInput.DescriptionNodeRef, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleInput) GetEnabled added in v0.18.0 

func (v *UpdateNodeRoleRuleInput) GetEnabled() *bool

GetEnabled returns UpdateNodeRoleRuleInput.Enabled, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleInput) GetStrictSubRoles added in v0.18.0 

func (v *UpdateNodeRoleRuleInput) GetStrictSubRoles() *bool

GetStrictSubRoles returns UpdateNodeRoleRuleInput.StrictSubRoles, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleInput) GetValidateBy added in v0.18.0 

func (v *UpdateNodeRoleRuleInput) GetValidateBy() *ContentValidator

GetValidateBy returns UpdateNodeRoleRuleInput.ValidateBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleInput) GetValidationTaskRef added in v0.18.0 

func (v *UpdateNodeRoleRuleInput) GetValidationTaskRef() *string

GetValidationTaskRef returns UpdateNodeRoleRuleInput.ValidationTaskRef, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleInput) GetWriters added in v0.18.0 

func (v *UpdateNodeRoleRuleInput) GetWriters() *NodeRoleWriters

GetWriters returns UpdateNodeRoleRuleInput.Writers, and is useful for accessing the field via an interface.

type UpdateNodeRoleRuleResponse added in v0.18.0 

type UpdateNodeRoleRuleResponse struct {
	// #1325 — change a rule by its id. With expectedRevision, a rule changed since
	// you read it is refused CONFLICT (extensions.currentRevision) and nothing is
	// written; omitted, the last writer wins. A rule you may not manage reads as
	// NOT_FOUND. A LOCKED rule (#1334) is refused with RULE_LOCKED (extensions
	// ruleId, role, sourceTemplateId) for EVERY caller: unlock it first
	// (unlockNodeRoleRule) or re-apply its required template.
	UpdateNodeRoleRule *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload `json:"updateNodeRoleRule"`
}

UpdateNodeRoleRuleResponse is returned by UpdateNodeRoleRule on success.

func UpdateNodeRoleRule added in v0.18.0 

func UpdateNodeRoleRule(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	input *UpdateNodeRoleRuleInput,
	expectedRevision int,
) (data_ *UpdateNodeRoleRuleResponse, err_ error)

`expectedRevision` is always sent: the CLI reads the rule's revision in the same command, so a rule someone changed in between is refused (CONFLICT) rather than overwritten.

func (*UpdateNodeRoleRuleResponse) GetUpdateNodeRoleRule added in v0.18.0 

func (v *UpdateNodeRoleRuleResponse) GetUpdateNodeRoleRule() *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload

GetUpdateNodeRoleRule returns UpdateNodeRoleRuleResponse.UpdateNodeRoleRule, and is useful for accessing the field via an interface.

type UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload added in v0.18.0 

type UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload struct {
	Rule *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule `json:"rule"`
	// Empty until #1327 adds its visibility warnings.
	Warnings []*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning `json:"warnings"`
}

UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload includes the requested fields of the GraphQL type NodeRoleRulePayload.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload) GetRule added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload) GetRule() *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule

GetRule returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload.Rule, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload) GetWarnings added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload) GetWarnings() []*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning

GetWarnings returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayload.Warnings, and is useful for accessing the field via an interface.

type UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule added in v0.18.0 

type UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule struct {
	NodeRoleRuleFields `json:"-"`
}

UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule includes the requested fields of the GraphQL type NodeRoleRule. The GraphQL type's documentation follows.

#1325 — one node-role rule. Task and description references are stored by node id (they survive moves) and returned as a URN and an id, each with its state. Both are given only when the state is OK; see NodeRoleRuleRefState.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTask() *string

GetAuthorTask returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTask, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskId() *string

GetAuthorTaskId returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetAuthorTaskState() NodeRoleRuleRefState

GetAuthorTaskState returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.AuthorTaskState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedAt() string

GetCreatedAt returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetCreatedBy() *string

GetCreatedBy returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.CreatedBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNode() *string

GetDescriptionNode returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNode, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeId() *string

GetDescriptionNodeId returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetDescriptionNodeState() NodeRoleRuleRefState

GetDescriptionNodeState returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.DescriptionNodeState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetEnabled() bool

GetEnabled returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Enabled, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetId() string

GetId returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Id, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetLocked() bool

GetLocked returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Locked, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRevision() int

GetRevision returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Revision, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetRole() string

GetRole returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Role, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplate() *NodeRoleRuleFieldsSourceTemplateNodeRoleRuleSourceTemplate

GetSourceTemplate returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplate, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetSourceTemplateId() *string

GetSourceTemplateId returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.SourceTemplateId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetStrictSubRoles() bool

GetStrictSubRoles returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.StrictSubRoles, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedAt() *string

GetUpdatedAt returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetUpdatedBy() *string

GetUpdatedBy returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.UpdatedBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidateBy() *ContentValidator

GetValidateBy returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidateBy, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTask() *string

GetValidationTask returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTask, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskId() *string

GetValidationTaskId returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskId, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetValidationTaskState() NodeRoleRuleRefState

GetValidationTaskState returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.ValidationTaskState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) GetWriters() NodeRoleWriters

GetWriters returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule.Writers, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) MarshalJSON() ([]byte, error)

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadRuleNodeRoleRule) UnmarshalJSON(b []byte) error

type UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning added in v0.18.0 

type UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning struct {
	MemoryConfigWarningFields `json:"-"`
}

UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning includes the requested fields of the GraphQL type MemoryConfigWarning. The GraphQL type's documentation follows.

#1325 — a non-fatal finding about a saved rule. Never changes the mutation's success.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetCode() string

GetCode returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Code, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetField() *string

GetField returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Field, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetRole() string

GetRole returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.Role, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskState() *NodeRoleRuleRefState

GetTaskState returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskState, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) GetTaskUrn() *string

GetTaskUrn returns UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning.TaskUrn, and is useful for accessing the field via an interface.

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) MarshalJSON() ([]byte, error)

func (*UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON added in v0.18.0 

func (v *UpdateNodeRoleRuleUpdateNodeRoleRuleNodeRoleRulePayloadWarningsMemoryConfigWarning) UnmarshalJSON(b []byte) error

type UpdateNodeUpdateNode added in v0.5.1 

type UpdateNodeUpdateNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

UpdateNodeUpdateNode includes the requested fields of the GraphQL type Node.

func (*UpdateNodeUpdateNode) GetId added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetId() string

GetId returns UpdateNodeUpdateNode.Id, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetIsRunnable added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetIsRunnable() *bool

GetIsRunnable returns UpdateNodeUpdateNode.IsRunnable, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetLoc added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetLoc() string

GetLoc returns UpdateNodeUpdateNode.Loc, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetMemoryId added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetMemoryId() string

GetMemoryId returns UpdateNodeUpdateNode.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetName added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetName() string

GetName returns UpdateNodeUpdateNode.Name, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetNodeType added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetNodeType() string

GetNodeType returns UpdateNodeUpdateNode.NodeType, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetRole added in v0.15.0 

func (v *UpdateNodeUpdateNode) GetRole() *string

GetRole returns UpdateNodeUpdateNode.Role, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetSeq added in v0.14.0 

func (v *UpdateNodeUpdateNode) GetSeq() *int

GetSeq returns UpdateNodeUpdateNode.Seq, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetTags added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetTags() []string

GetTags returns UpdateNodeUpdateNode.Tags, and is useful for accessing the field via an interface.

func (*UpdateNodeUpdateNode) GetUpdatedAt added in v0.5.1 

func (v *UpdateNodeUpdateNode) GetUpdatedAt() string

GetUpdatedAt returns UpdateNodeUpdateNode.UpdatedAt, and is useful for accessing the field via an interface.

type UpdateObjectResponse added in v0.8.0 

type UpdateObjectResponse struct {
	// Merge fields into an existing object (server-side atomic shallow merge +
	// schema conformance on the result). 'ref' is the object id (or node URN);
	// 'fields' wins on key collision, unmentioned keys preserved. Returns the
	// updated flat object. The merge is shallow for EVERY field, including one
	// named 'exports': the per-host merge-patch updateNodeProperties applies to
	// 'properties.exports' (#1227) is a node-level skill-declaration rule and
	// does not apply to object fields.
	UpdateObject json.RawMessage `json:"updateObject"`
}

UpdateObjectResponse is returned by UpdateObject on success.

func UpdateObject added in v0.8.0 

func UpdateObject(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	fields json.RawMessage,
	reason *string,
) (data_ *UpdateObjectResponse, err_ error)

Atomic server-side shallow merge of fields into the object; returns the merged flat record. reason is optional (recorded in revision history).

func (*UpdateObjectResponse) GetUpdateObject added in v0.8.0 

func (v *UpdateObjectResponse) GetUpdateObject() json.RawMessage

GetUpdateObject returns UpdateObjectResponse.UpdateObject, and is useful for accessing the field via an interface.

type UpdateOrgMemberResponse added in v0.3.0 

type UpdateOrgMemberResponse struct {
	// Accepts the entity's ID or URN (orgId).
	UpdateOrgMember *UpdateOrgMemberUpdateOrgMember `json:"updateOrgMember"`
}

UpdateOrgMemberResponse is returned by UpdateOrgMember on success.

func UpdateOrgMember added in v0.3.0 

func UpdateOrgMember(
	ctx_ context.Context,
	client_ graphql.Client,
	orgId string,
	userId string,
	role Role,
) (data_ *UpdateOrgMemberResponse, err_ error)

func (*UpdateOrgMemberResponse) GetUpdateOrgMember added in v0.3.0 

func (v *UpdateOrgMemberResponse) GetUpdateOrgMember() *UpdateOrgMemberUpdateOrgMember

GetUpdateOrgMember returns UpdateOrgMemberResponse.UpdateOrgMember, and is useful for accessing the field via an interface.

type UpdateOrgMemberUpdateOrgMember added in v0.3.0 

type UpdateOrgMemberUpdateOrgMember struct {
	Id string `json:"id"`
	// Target member's role in this org. Null when the viewer isn't an ADMIN/OWNER of the org (#384 field-level visibility); always visible for one's own membership.
	Role *Role                               `json:"role"`
	User *UpdateOrgMemberUpdateOrgMemberUser `json:"user"`
}

UpdateOrgMemberUpdateOrgMember includes the requested fields of the GraphQL type OrgMember. The GraphQL type's documentation follows.

Per-organization membership record for a user.

func (*UpdateOrgMemberUpdateOrgMember) GetId added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMember) GetId() string

GetId returns UpdateOrgMemberUpdateOrgMember.Id, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMember) GetRole added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMember) GetRole() *Role

GetRole returns UpdateOrgMemberUpdateOrgMember.Role, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMember) GetUser added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMember) GetUser() *UpdateOrgMemberUpdateOrgMemberUser

GetUser returns UpdateOrgMemberUpdateOrgMember.User, and is useful for accessing the field via an interface.

type UpdateOrgMemberUpdateOrgMemberUser added in v0.3.0 

type UpdateOrgMemberUpdateOrgMemberUser struct {
	UserFields `json:"-"`
}

UpdateOrgMemberUpdateOrgMemberUser includes the requested fields of the GraphQL type User.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetEmail added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetEmail() *string

GetEmail returns UpdateOrgMemberUpdateOrgMemberUser.Email, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetExternalAppId added in v0.9.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetExternalAppId() *string

GetExternalAppId returns UpdateOrgMemberUpdateOrgMemberUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetExternalId added in v0.9.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetExternalId() *string

GetExternalId returns UpdateOrgMemberUpdateOrgMemberUser.ExternalId, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetGithubId added in v0.9.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetGithubId() *int

GetGithubId returns UpdateOrgMemberUpdateOrgMemberUser.GithubId, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetGithubUsername added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetGithubUsername() *string

GetGithubUsername returns UpdateOrgMemberUpdateOrgMemberUser.GithubUsername, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetHandle added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetHandle() *string

GetHandle returns UpdateOrgMemberUpdateOrgMemberUser.Handle, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetId added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetId() string

GetId returns UpdateOrgMemberUpdateOrgMemberUser.Id, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetIdentityProvider added in v0.9.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetIdentityProvider() *string

GetIdentityProvider returns UpdateOrgMemberUpdateOrgMemberUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetLinkedAt added in v0.9.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetLinkedAt() *string

GetLinkedAt returns UpdateOrgMemberUpdateOrgMemberUser.LinkedAt, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetName added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetName() *string

GetName returns UpdateOrgMemberUpdateOrgMemberUser.Name, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetRoles added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetRoles() []Role

GetRoles returns UpdateOrgMemberUpdateOrgMemberUser.Roles, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) GetUrn added in v0.14.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) GetUrn() *string

GetUrn returns UpdateOrgMemberUpdateOrgMemberUser.Urn, and is useful for accessing the field via an interface.

func (*UpdateOrgMemberUpdateOrgMemberUser) MarshalJSON added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) MarshalJSON() ([]byte, error)

func (*UpdateOrgMemberUpdateOrgMemberUser) UnmarshalJSON added in v0.3.0 

func (v *UpdateOrgMemberUpdateOrgMemberUser) UnmarshalJSON(b []byte) error

type UpdateOrganizationResponse added in v0.3.0 

type UpdateOrganizationResponse struct {
	// Update an Organization.
	//
	// Accepts the entity's ID or URN.
	UpdateOrganization *UpdateOrganizationUpdateOrganization `json:"updateOrganization"`
}

UpdateOrganizationResponse is returned by UpdateOrganization on success.

func UpdateOrganization added in v0.3.0 

func UpdateOrganization(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	name *string,
	urn *string,
	listedOnMarketplace *bool,
) (data_ *UpdateOrganizationResponse, err_ error)

func (*UpdateOrganizationResponse) GetUpdateOrganization added in v0.3.0 

func (v *UpdateOrganizationResponse) GetUpdateOrganization() *UpdateOrganizationUpdateOrganization

GetUpdateOrganization returns UpdateOrganizationResponse.UpdateOrganization, and is useful for accessing the field via an interface.

type UpdateOrganizationUpdateOrganization added in v0.3.0 

type UpdateOrganizationUpdateOrganization struct {
	OrgFields `json:"-"`
}

UpdateOrganizationUpdateOrganization includes the requested fields of the GraphQL type Organization. The GraphQL type's documentation follows.

A company or team that owns one or more Hadron memories.

func (*UpdateOrganizationUpdateOrganization) GetCreatedAt added in v0.3.0 

func (v *UpdateOrganizationUpdateOrganization) GetCreatedAt() string

GetCreatedAt returns UpdateOrganizationUpdateOrganization.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateOrganizationUpdateOrganization) GetId added in v0.3.0 

func (v *UpdateOrganizationUpdateOrganization) GetId() string

GetId returns UpdateOrganizationUpdateOrganization.Id, and is useful for accessing the field via an interface.

func (*UpdateOrganizationUpdateOrganization) GetListedOnMarketplace added in v0.9.0 

func (v *UpdateOrganizationUpdateOrganization) GetListedOnMarketplace() bool

GetListedOnMarketplace returns UpdateOrganizationUpdateOrganization.ListedOnMarketplace, and is useful for accessing the field via an interface.

func (*UpdateOrganizationUpdateOrganization) GetName added in v0.3.0 

func (v *UpdateOrganizationUpdateOrganization) GetName() string

GetName returns UpdateOrganizationUpdateOrganization.Name, and is useful for accessing the field via an interface.

func (*UpdateOrganizationUpdateOrganization) GetUpdatedAt added in v0.3.0 

func (v *UpdateOrganizationUpdateOrganization) GetUpdatedAt() string

GetUpdatedAt returns UpdateOrganizationUpdateOrganization.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateOrganizationUpdateOrganization) GetUrn added in v0.3.0 

func (v *UpdateOrganizationUpdateOrganization) GetUrn() string

GetUrn returns UpdateOrganizationUpdateOrganization.Urn, and is useful for accessing the field via an interface.

func (*UpdateOrganizationUpdateOrganization) MarshalJSON added in v0.3.0 

func (v *UpdateOrganizationUpdateOrganization) MarshalJSON() ([]byte, error)

func (*UpdateOrganizationUpdateOrganization) UnmarshalJSON added in v0.3.0 

func (v *UpdateOrganizationUpdateOrganization) UnmarshalJSON(b []byte) error

type UpdateRegisterEntryInput added in v0.15.0 

type UpdateRegisterEntryInput struct {
	Description *string       `json:"description,omitempty"`
	MentionOnly *bool         `json:"mentionOnly,omitempty"`
	Role        *RegisterRole `json:"role,omitempty"`
}

func (*UpdateRegisterEntryInput) GetDescription added in v0.15.0 

func (v *UpdateRegisterEntryInput) GetDescription() *string

GetDescription returns UpdateRegisterEntryInput.Description, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryInput) GetMentionOnly added in v0.15.0 

func (v *UpdateRegisterEntryInput) GetMentionOnly() *bool

GetMentionOnly returns UpdateRegisterEntryInput.MentionOnly, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryInput) GetRole added in v0.15.0 

func (v *UpdateRegisterEntryInput) GetRole() *RegisterRole

GetRole returns UpdateRegisterEntryInput.Role, and is useful for accessing the field via an interface.

type UpdateRegisterEntryResponse added in v0.15.0 

type UpdateRegisterEntryResponse struct {
	// Spec 049 Phase 5 — change a row's role / mentionOnly / description (the owner's gate).
	UpdateRegisterEntry *UpdateRegisterEntryUpdateRegisterEntry `json:"updateRegisterEntry"`
}

UpdateRegisterEntryResponse is returned by UpdateRegisterEntry on success.

func UpdateRegisterEntry added in v0.15.0 

func UpdateRegisterEntry(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	input *UpdateRegisterEntryInput,
) (data_ *UpdateRegisterEntryResponse, err_ error)

Update carries ONLY role / mentionOnly / description — the attendee and the Channel are immutable, so "move this registration" is delete + create and the command must not pretend otherwise. Each field is omitempty so an unset flag is OMITTED (preserve) rather than sent as null (clear).

func (*UpdateRegisterEntryResponse) GetUpdateRegisterEntry added in v0.15.0 

func (v *UpdateRegisterEntryResponse) GetUpdateRegisterEntry() *UpdateRegisterEntryUpdateRegisterEntry

GetUpdateRegisterEntry returns UpdateRegisterEntryResponse.UpdateRegisterEntry, and is useful for accessing the field via an interface.

type UpdateRegisterEntryUpdateRegisterEntry added in v0.15.0 

type UpdateRegisterEntryUpdateRegisterEntry struct {
	RegisterEntryFields `json:"-"`
}

UpdateRegisterEntryUpdateRegisterEntry includes the requested fields of the GraphQL type RegisterEntry. The GraphQL type's documentation follows.

A REGISTER ENTRY (spec 049, D-2026-09-13-007): "this attendee takes part in this Channel". The attendee is a Worker when cast, otherwise an Agent in an App; both null = every attendee in the owner's context (org-wide for an organization row, App-wide for an App row). Not a trigger list — a row never starts a run. The register never grants: what the attendee may read or post is the Channel's host memory's decision. Not exportable.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetAttendeeUrn added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetAttendeeUrn() *string

GetAttendeeUrn returns UpdateRegisterEntryUpdateRegisterEntry.AttendeeUrn, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetChannelId added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetChannelId() string

GetChannelId returns UpdateRegisterEntryUpdateRegisterEntry.ChannelId, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetCreatedAt added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetCreatedAt() string

GetCreatedAt returns UpdateRegisterEntryUpdateRegisterEntry.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetDescription added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetDescription() *string

GetDescription returns UpdateRegisterEntryUpdateRegisterEntry.Description, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetId added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetId() string

GetId returns UpdateRegisterEntryUpdateRegisterEntry.Id, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetInstallDefault added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetInstallDefault() bool

GetInstallDefault returns UpdateRegisterEntryUpdateRegisterEntry.InstallDefault, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetMentionOnly added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetMentionOnly() bool

GetMentionOnly returns UpdateRegisterEntryUpdateRegisterEntry.MentionOnly, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetOrganizationId added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetOrganizationId() *string

GetOrganizationId returns UpdateRegisterEntryUpdateRegisterEntry.OrganizationId, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetOwnerId added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetOwnerId() string

GetOwnerId returns UpdateRegisterEntryUpdateRegisterEntry.OwnerId, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetOwnerType added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetOwnerType() RegisterOwnerType

GetOwnerType returns UpdateRegisterEntryUpdateRegisterEntry.OwnerType, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetRole added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetRole() RegisterRole

GetRole returns UpdateRegisterEntryUpdateRegisterEntry.Role, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) GetUpdatedAt added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) GetUpdatedAt() *string

GetUpdatedAt returns UpdateRegisterEntryUpdateRegisterEntry.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateRegisterEntryUpdateRegisterEntry) MarshalJSON added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) MarshalJSON() ([]byte, error)

func (*UpdateRegisterEntryUpdateRegisterEntry) UnmarshalJSON added in v0.15.0 

func (v *UpdateRegisterEntryUpdateRegisterEntry) UnmarshalJSON(b []byte) error

type UpdateReviewNodeResponse added in v0.14.0 

type UpdateReviewNodeResponse struct {
	// #1201 — the UPDATE door for the review kind, and the counterpart of
	// createReviewNode. Same posture: pure routing, exempt from its own kind only;
	// its MCP counterpart is hadron_update_review.
	//
	// It is needed because the gate reads the RESULTING state: editing a node that
	// already carries this kind still produces one, so the generic updateNode
	// refuses it even when the edit touches neither signal. That is the point — a
	// review node must not be rewritable through the generic surface.
	//
	// Identical to updateNode otherwise, selectors included ('id' XOR 'memoryId' +
	// 'loc'); it never creates and never moves.
	UpdateReviewNode *UpdateReviewNodeUpdateReviewNode `json:"updateReviewNode"`
}

UpdateReviewNodeResponse is returned by UpdateReviewNode on success.

func UpdateReviewNode added in v0.14.0 

func UpdateReviewNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *UpdateNodeInput,
) (data_ *UpdateReviewNodeResponse, err_ error)

func (*UpdateReviewNodeResponse) GetUpdateReviewNode added in v0.14.0 

func (v *UpdateReviewNodeResponse) GetUpdateReviewNode() *UpdateReviewNodeUpdateReviewNode

GetUpdateReviewNode returns UpdateReviewNodeResponse.UpdateReviewNode, and is useful for accessing the field via an interface.

type UpdateReviewNodeUpdateReviewNode added in v0.14.0 

type UpdateReviewNodeUpdateReviewNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

UpdateReviewNodeUpdateReviewNode includes the requested fields of the GraphQL type Node.

func (*UpdateReviewNodeUpdateReviewNode) GetId added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetId() string

GetId returns UpdateReviewNodeUpdateReviewNode.Id, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetIsRunnable added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetIsRunnable() *bool

GetIsRunnable returns UpdateReviewNodeUpdateReviewNode.IsRunnable, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetLoc added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetLoc() string

GetLoc returns UpdateReviewNodeUpdateReviewNode.Loc, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetMemoryId added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetMemoryId() string

GetMemoryId returns UpdateReviewNodeUpdateReviewNode.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetName added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetName() string

GetName returns UpdateReviewNodeUpdateReviewNode.Name, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetNodeType added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetNodeType() string

GetNodeType returns UpdateReviewNodeUpdateReviewNode.NodeType, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetRole added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetRole() *string

GetRole returns UpdateReviewNodeUpdateReviewNode.Role, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetSeq added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetSeq() *int

GetSeq returns UpdateReviewNodeUpdateReviewNode.Seq, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetTags added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetTags() []string

GetTags returns UpdateReviewNodeUpdateReviewNode.Tags, and is useful for accessing the field via an interface.

func (*UpdateReviewNodeUpdateReviewNode) GetUpdatedAt added in v0.14.0 

func (v *UpdateReviewNodeUpdateReviewNode) GetUpdatedAt() string

GetUpdatedAt returns UpdateReviewNodeUpdateReviewNode.UpdatedAt, and is useful for accessing the field via an interface.

type UpdateScopeInput added in v0.14.0 

type UpdateScopeInput struct {
	Description *string  `json:"description,omitempty"`
	MemoryRefs  []string `json:"memoryRefs,omitempty"`
	Name        *string  `json:"name,omitempty"`
}

All optional. `memoryRefs`, when passed, REPLACES the list (it is the new order).

func (*UpdateScopeInput) GetDescription added in v0.14.0 

func (v *UpdateScopeInput) GetDescription() *string

GetDescription returns UpdateScopeInput.Description, and is useful for accessing the field via an interface.

func (*UpdateScopeInput) GetMemoryRefs added in v0.14.0 

func (v *UpdateScopeInput) GetMemoryRefs() []string

GetMemoryRefs returns UpdateScopeInput.MemoryRefs, and is useful for accessing the field via an interface.

func (*UpdateScopeInput) GetName added in v0.14.0 

func (v *UpdateScopeInput) GetName() *string

GetName returns UpdateScopeInput.Name, and is useful for accessing the field via an interface.

type UpdateScopeResponse added in v0.14.0 

type UpdateScopeResponse struct {
	// Spec 049 Phase 2 — update a scope you may write (auth as createScope). memoryRefs replaces the ordered list.
	UpdateScope *UpdateScopeUpdateScope `json:"updateScope"`
}

UpdateScopeResponse is returned by UpdateScope on success.

func UpdateScope added in v0.14.0 

func UpdateScope(
	ctx_ context.Context,
	client_ graphql.Client,
	ref string,
	input *UpdateScopeInput,
) (data_ *UpdateScopeResponse, err_ error)

Update a scope. WIRE SEMANTICS: an OMITTED input field means preserve, an explicit null means clear — so every optional field carries omitempty and a nil pointer is omitted rather than sent as null. Dropping an omitempty here makes an unset flag silently clear the field (CLAUDE.md; and the schedule `scopeRef` regression a refresh introduced, findings:a-schema-refresh-can- regress-an-unrelated-write).

memoryRefs REPLACES the ordered list rather than appending to it.

The `for:` directives below only bind when the operation's variable list is on its own lines — with a single-line signature genqlient reports "for is only applicable to operations and arguments" (findings:genqlient-for- directive-needs-multiline-signature). Keep this signature expanded.

func (*UpdateScopeResponse) GetUpdateScope added in v0.14.0 

func (v *UpdateScopeResponse) GetUpdateScope() *UpdateScopeUpdateScope

GetUpdateScope returns UpdateScopeResponse.UpdateScope, and is useful for accessing the field via an interface.

type UpdateScopeUpdateScope added in v0.14.0 

type UpdateScopeUpdateScope struct {
	ScopeFields   `json:"-"`
	ScopeMemories `json:"-"`
}

UpdateScopeUpdateScope includes the requested fields of the GraphQL type Scope. The GraphQL type's documentation follows.

A named search SCOPE: an ORDERED list of memories with exactly one owner (organization | Agent | App). Selects memories only — no saved filter, no retrieval parameters — and NEVER grants: `memories` is the stored list ∩ what YOU may read (D-2026-09-13-004), and `hiddenMemoryCount` says how many you cannot see, as a count only. Names are unique per owner; `global` and `app` are reserved (the ladder's own views). Collisions across owners in an App's context resolve App › Agent › organization, never unioned.

func (*UpdateScopeUpdateScope) GetCreatedAt added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetCreatedAt() string

GetCreatedAt returns UpdateScopeUpdateScope.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetDescription added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetDescription() *string

GetDescription returns UpdateScopeUpdateScope.Description, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetHiddenMemoryCount added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetHiddenMemoryCount() int

GetHiddenMemoryCount returns UpdateScopeUpdateScope.HiddenMemoryCount, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetId added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetId() string

GetId returns UpdateScopeUpdateScope.Id, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetMemories added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetMemories() []*ScopeMemoriesMemoriesScopeMemoryEntry

GetMemories returns UpdateScopeUpdateScope.Memories, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetMemoryCount added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetMemoryCount() int

GetMemoryCount returns UpdateScopeUpdateScope.MemoryCount, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetName added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetName() string

GetName returns UpdateScopeUpdateScope.Name, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetOwnerId added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetOwnerId() string

GetOwnerId returns UpdateScopeUpdateScope.OwnerId, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetOwnerType added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetOwnerType() ScopeOwnerType

GetOwnerType returns UpdateScopeUpdateScope.OwnerType, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetOwnerUrn added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetOwnerUrn() *string

GetOwnerUrn returns UpdateScopeUpdateScope.OwnerUrn, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) GetUpdatedAt added in v0.14.0 

func (v *UpdateScopeUpdateScope) GetUpdatedAt() *string

GetUpdatedAt returns UpdateScopeUpdateScope.UpdatedAt, and is useful for accessing the field via an interface.

func (*UpdateScopeUpdateScope) MarshalJSON added in v0.14.0 

func (v *UpdateScopeUpdateScope) MarshalJSON() ([]byte, error)

func (*UpdateScopeUpdateScope) UnmarshalJSON added in v0.14.0 

func (v *UpdateScopeUpdateScope) UnmarshalJSON(b []byte) error

type UpdateSpecNodeResponse added in v0.14.0 

type UpdateSpecNodeResponse struct {
	// #1201 — the UPDATE door for the spec kind, and the counterpart of
	// createSpecNode. Same posture: pure routing, exempt from its own kind only,
	// not an MCP tool.
	//
	// It is needed because the gate reads the RESULTING state: editing a node that
	// already carries this kind still produces one, so the generic updateNode
	// refuses it even when the edit touches neither signal. That is the point — a
	// spec node must not be rewritable through the generic surface.
	//
	// Identical to updateNode otherwise, selectors included ('id' XOR 'memoryId' +
	// 'loc'); it never creates and never moves.
	UpdateSpecNode *UpdateSpecNodeUpdateSpecNode `json:"updateSpecNode"`
}

UpdateSpecNodeResponse is returned by UpdateSpecNode on success.

func UpdateSpecNode added in v0.14.0 

func UpdateSpecNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *UpdateNodeInput,
) (data_ *UpdateSpecNodeResponse, err_ error)

The UPDATE door for the spec kind (#1201) — createSpecNode's counterpart.

It is needed because the gate reads the kind the node is now as well as the kind it will be: editing a node that already carries `role: "spec"` touches the spec kind, so the generic `updateNode` refuses it even when the edit touches neither signal. That is the point — a spec node must not be rewritable through the generic surface.

Identical to `updateNode` otherwise, SELECTORS INCLUDED (`id` XOR `memoryId` + `loc`), and it never creates and never moves. So omit-to-preserve holds here exactly as it does there, which is what `spec edit` depends on and what routing an edit through a CREATE door could never have given it (#1192).

func (*UpdateSpecNodeResponse) GetUpdateSpecNode added in v0.14.0 

func (v *UpdateSpecNodeResponse) GetUpdateSpecNode() *UpdateSpecNodeUpdateSpecNode

GetUpdateSpecNode returns UpdateSpecNodeResponse.UpdateSpecNode, and is useful for accessing the field via an interface.

type UpdateSpecNodeUpdateSpecNode added in v0.14.0 

type UpdateSpecNodeUpdateSpecNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
	// 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: the abstract may not reflect current content when the two differ, OR when this is NULL on a node that has both an abstract and content (#1128 — an abstract written before the body existed was never fingerprinted, so it has never been checked against it; that reads as unverified, not as verified). NULL is only a clean state when the node has no abstract, or no content for the abstract to describe. Note restoreNodeRevision restores this field verbatim, so restoring a snapshot taken while it was NULL reinstates the unverified state — correctly, since that abstract has never been checked against the restored content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string `json:"abstractOriginHash"`
}

UpdateSpecNodeUpdateSpecNode includes the requested fields of the GraphQL type Node.

func (*UpdateSpecNodeUpdateSpecNode) GetAbstractOriginHash added in v0.19.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetAbstractOriginHash() *string

GetAbstractOriginHash returns UpdateSpecNodeUpdateSpecNode.AbstractOriginHash, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetId added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetId() string

GetId returns UpdateSpecNodeUpdateSpecNode.Id, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetIsRunnable added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetIsRunnable() *bool

GetIsRunnable returns UpdateSpecNodeUpdateSpecNode.IsRunnable, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetLoc added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetLoc() string

GetLoc returns UpdateSpecNodeUpdateSpecNode.Loc, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetMemoryId added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetMemoryId() string

GetMemoryId returns UpdateSpecNodeUpdateSpecNode.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetName added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetName() string

GetName returns UpdateSpecNodeUpdateSpecNode.Name, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetNodeType added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetNodeType() string

GetNodeType returns UpdateSpecNodeUpdateSpecNode.NodeType, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetRole added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetRole() *string

GetRole returns UpdateSpecNodeUpdateSpecNode.Role, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetSeq added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetSeq() *int

GetSeq returns UpdateSpecNodeUpdateSpecNode.Seq, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetTags added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetTags() []string

GetTags returns UpdateSpecNodeUpdateSpecNode.Tags, and is useful for accessing the field via an interface.

func (*UpdateSpecNodeUpdateSpecNode) GetUpdatedAt added in v0.14.0 

func (v *UpdateSpecNodeUpdateSpecNode) GetUpdatedAt() string

GetUpdatedAt returns UpdateSpecNodeUpdateSpecNode.UpdatedAt, and is useful for accessing the field via an interface.

type UpdateTaskNodeResponse added in v0.14.0 

type UpdateTaskNodeResponse struct {
	// #1201 — the UPDATE door for the task kind, and the counterpart of
	// createTaskNode. Same posture: pure routing, exempt from its own kind only;
	// its MCP counterpart is hadron_update_task.
	//
	// It is needed because the gate reads the RESULTING state: editing a node that
	// already carries this kind still produces one, so the generic updateNode
	// refuses it even when the edit touches neither signal. That is the point — a
	// task node must not be rewritable through the generic surface.
	//
	// Identical to updateNode otherwise, selectors included ('id' XOR 'memoryId' +
	// 'loc'); it never creates and never moves.
	UpdateTaskNode *UpdateTaskNodeUpdateTaskNode `json:"updateTaskNode"`
}

UpdateTaskNodeResponse is returned by UpdateTaskNode on success.

func UpdateTaskNode added in v0.14.0 

func UpdateTaskNode(
	ctx_ context.Context,
	client_ graphql.Client,
	input *UpdateNodeInput,
) (data_ *UpdateTaskNodeResponse, err_ error)

func (*UpdateTaskNodeResponse) GetUpdateTaskNode added in v0.14.0 

func (v *UpdateTaskNodeResponse) GetUpdateTaskNode() *UpdateTaskNodeUpdateTaskNode

GetUpdateTaskNode returns UpdateTaskNodeResponse.UpdateTaskNode, and is useful for accessing the field via an interface.

type UpdateTaskNodeUpdateTaskNode added in v0.14.0 

type UpdateTaskNodeUpdateTaskNode struct {
	Id       string `json:"id"`
	MemoryId string `json:"memoryId"`
	Loc      string `json:"loc"`
	Name     string `json:"name"`
	// The PLATFORM-kind axis (info / task / prompt / record / …). Load-bearing for
	// retrieval and rendering.
	//
	// NOT 'objectType', which says which domain COLLECTION a node belongs to, and
	// NOT 'role', which says what the node is FOR. Three kind-ish fields is the
	// accepted price of keeping retrieval stable while roles stay open, so each
	// one says what it is not — mixing them up is the predictable failure.
	NodeType string   `json:"nodeType"`
	Tags     []string `json:"tags"`
	Seq      *int     `json:"seq"`
	// Whether this node can be run as a task (nullable; #513) — it drives the tree
	// action indicator, and since #1201 it is also the CAPABILITY gate for the
	// task kind: a write that would PRODUCE a runnable node must come through
	// createTaskNode / updateTaskNode. Gated here rather than on a label because
	// omitting a label is free, while omitting this means the node does not run.
	IsRunnable *bool `json:"isRunnable"`
	// #1201 — what this node is FOR, as an OPEN string. Set it to anything; the
	// platform reads a small CLOSED subset and ignores every other value.
	//
	// NOT 'nodeType' (the platform-kind axis, load-bearing for retrieval) and NOT
	// 'objectType' (the collection discriminator, schema-validated). This field
	// does not change default retrieval or ranking; NodeFilter.role explicitly
	// selects its exact dotted family (#1322).
	//
	// A GOVERNED family routes the write to that kind's own authoring door, and
	// the generic node surface is refused: 'review' / 'review.*' and 'spec' /
	// 'spec.*' today, alongside the task kind, which is gated on 'isRunnable'
	// rather than on any label because a label can be omitted and a capability
	// cannot. Other values are inert unless a caller explicitly filters for them.
	Role      *string `json:"role"`
	UpdatedAt string  `json:"updatedAt"`
}

UpdateTaskNodeUpdateTaskNode includes the requested fields of the GraphQL type Node.

func (*UpdateTaskNodeUpdateTaskNode) GetId added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetId() string

GetId returns UpdateTaskNodeUpdateTaskNode.Id, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetIsRunnable added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetIsRunnable() *bool

GetIsRunnable returns UpdateTaskNodeUpdateTaskNode.IsRunnable, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetLoc added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetLoc() string

GetLoc returns UpdateTaskNodeUpdateTaskNode.Loc, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetMemoryId added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetMemoryId() string

GetMemoryId returns UpdateTaskNodeUpdateTaskNode.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetName added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetName() string

GetName returns UpdateTaskNodeUpdateTaskNode.Name, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetNodeType added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetNodeType() string

GetNodeType returns UpdateTaskNodeUpdateTaskNode.NodeType, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetRole added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetRole() *string

GetRole returns UpdateTaskNodeUpdateTaskNode.Role, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetSeq added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetSeq() *int

GetSeq returns UpdateTaskNodeUpdateTaskNode.Seq, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetTags added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetTags() []string

GetTags returns UpdateTaskNodeUpdateTaskNode.Tags, and is useful for accessing the field via an interface.

func (*UpdateTaskNodeUpdateTaskNode) GetUpdatedAt added in v0.14.0 

func (v *UpdateTaskNodeUpdateTaskNode) GetUpdatedAt() string

GetUpdatedAt returns UpdateTaskNodeUpdateTaskNode.UpdatedAt, and is useful for accessing the field via an interface.

type UpdateTeamCollectionsResponse added in v0.9.0 

type UpdateTeamCollectionsResponse struct {
	// (Re)declare the server-owned team collections on the team App's shared
	// memory, converging a drifted declaration to the canonical definition
	// (hadron-cli#401). Idempotent: 'changed' is false when the declaration
	// already matched.
	//
	// Why this exists as its own operation. recordTeamWork declares the worklog
	// collection on first write, but deliberately leaves an ALREADY-declared one
	// untouched — a deployment that tightened it governs that surface too, which
	// is the point of schema governance. A declaration is not always a
	// deployment decision though: 'hadron team init' shipped a client-side copy
	// of this schema that has since drifted from the server's (its kind enum
	// predates the 'repo' kind), so on a CLI-bootstrapped memory a
	// recordTeamWork(kind: 'repo') is refused by a rule nobody chose.
	// Overriding silently would break real governance; this operation makes
	// convergence an explicit act instead.
	//
	// Only the server-owned collections are rewritten — every other collection
	// on the memory is preserved.
	//
	// Authorization: owner or org ADMIN on the memory, the same bar updateMemory
	// applies to a schema edit. Team participation is deliberately NOT enough:
	// it lets you record work, not redefine what a record is.
	//
	// Typed refusals: APP_UNINSTALLED, UNAUTHENTICATED, TEAM_AGENT_NOT_FOUND /
	// TEAM_AGENT_AMBIGUOUS (when the App's shared memory must still be
	// bootstrapped).
	//
	// Accepts the entity's ID or URN.
	UpdateTeamCollections *UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload `json:"updateTeamCollections"`
}

UpdateTeamCollectionsResponse is returned by UpdateTeamCollections on success.

func UpdateTeamCollections added in v0.9.0 

func UpdateTeamCollections(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
) (data_ *UpdateTeamCollectionsResponse, err_ error)

hadron-cli#401: the worklog collection SCHEMA is the server's (it declares it when provisioning, and converges a drifted declaration here) — the CLI used to ship its own copy as a Go constant, which had already drifted from the server's `kind` enum.

func (*UpdateTeamCollectionsResponse) GetUpdateTeamCollections added in v0.9.0 

func (v *UpdateTeamCollectionsResponse) GetUpdateTeamCollections() *UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload

GetUpdateTeamCollections returns UpdateTeamCollectionsResponse.UpdateTeamCollections, and is useful for accessing the field via an interface.

type UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload added in v0.9.0 

type UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload struct {
	// The team App's shared memory the declaration was written to.
	MemoryId string `json:"memoryId"`
	// The server-owned collections declared on it.
	Collections []string `json:"collections"`
	// False when the declaration already matched the canonical definition (idempotent no-op).
	Changed bool `json:"changed"`
}

UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload includes the requested fields of the GraphQL type TeamCollectionsPayload. The GraphQL type's documentation follows.

Result of updateTeamCollections (hadron-cli#401).

func (*UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload) GetChanged added in v0.9.0 

func (v *UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload) GetChanged() bool

GetChanged returns UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload.Changed, and is useful for accessing the field via an interface.

func (*UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload) GetCollections added in v0.9.0 

func (v *UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload) GetCollections() []string

GetCollections returns UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload.Collections, and is useful for accessing the field via an interface.

func (*UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload) GetMemoryId added in v0.9.0 

func (v *UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload) GetMemoryId() string

GetMemoryId returns UpdateTeamCollectionsUpdateTeamCollectionsTeamCollectionsPayload.MemoryId, and is useful for accessing the field via an interface.

type UpdateTeamRoleMetaResponse added in v0.9.0 

type UpdateTeamRoleMetaResponse struct {
	// #960 — edit a roles:<role> definition. Omitted fields preserve. Unknown
	// role: WORKER_ROLE_NOT_FOUND. Same authorization as createTeamRole.
	//
	// #1024: `repos` sets the role's repo affinity. Omitted PRESERVES; an empty
	// array CLEARS; explicit `null` is treated as OMITTED, not as a clear — worth
	// stating because a client whose variables default to null would otherwise
	// have to guess, and the two readings differ (preserve vs wipe). Pass `[]`
	// to clear deliberately. It is merged into the node's `data` rather than replacing it,
	// and the write is guarded on the row's revision — a concurrent generic node
	// write (updateNode, hadron_update_node_data) refuses TEAM_ROLE_DATA_CONFLICT
	// rather than silently reverting, since those surfaces do not take this one's
	// lock. Retry after re-reading. A description-only edit carries no data and
	// takes no guard.
	//
	// #1050: with the register gone this otherwise edits the description alone,
	// so the #987 expectedNames compare-and-swap is gone too — it existed solely
	// to stop two concurrent wholesale register writes silently dropping each
	// other's newly added FREE names, a hazard that cannot arise when the write
	// owns no list. That closes #1028 (the client-side register CAS arithmetic)
	// outright rather than by implementing it.
	UpdateTeamRole *UpdateTeamRoleMetaUpdateTeamRole `json:"updateTeamRole"`
}

UpdateTeamRoleMetaResponse is returned by UpdateTeamRoleMeta on success.

func UpdateTeamRoleMeta added in v0.9.0 

func UpdateTeamRoleMeta(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	teamAgentRef *string,
	role string,
	description *string,
) (data_ *UpdateTeamRoleMetaResponse, err_ error)

`role update` now sets exactly one field. description keeps its omitempty (omitted is "preserve" on this server, CLAUDE.md), so an update that names nothing is a no-op rather than a clear.

func (*UpdateTeamRoleMetaResponse) GetUpdateTeamRole added in v0.9.0 

func (v *UpdateTeamRoleMetaResponse) GetUpdateTeamRole() *UpdateTeamRoleMetaUpdateTeamRole

GetUpdateTeamRole returns UpdateTeamRoleMetaResponse.UpdateTeamRole, and is useful for accessing the field via an interface.

type UpdateTeamRoleMetaUpdateTeamRole added in v0.9.0 

type UpdateTeamRoleMetaUpdateTeamRole struct {
	TeamRoleFields `json:"-"`
}

UpdateTeamRoleMetaUpdateTeamRole includes the requested fields of the GraphQL type TeamRole. The GraphQL type's documentation follows.

A role definition (#960): the roles:<role> node in the Team Agent's system memory. #1050: it carries no name register — a role is a definition, not an allocation pool. The prompt template is NOT here — with the Worker model (#974) it lives on the role-agent (personaRole + systemPrompt); roleAgent points at it.

func (*UpdateTeamRoleMetaUpdateTeamRole) GetDescription added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) GetDescription() *string

GetDescription returns UpdateTeamRoleMetaUpdateTeamRole.Description, and is useful for accessing the field via an interface.

func (*UpdateTeamRoleMetaUpdateTeamRole) GetHasNamePlaceholder added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) GetHasNamePlaceholder() *bool

GetHasNamePlaceholder returns UpdateTeamRoleMetaUpdateTeamRole.HasNamePlaceholder, and is useful for accessing the field via an interface.

func (*UpdateTeamRoleMetaUpdateTeamRole) GetLoc added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) GetLoc() string

GetLoc returns UpdateTeamRoleMetaUpdateTeamRole.Loc, and is useful for accessing the field via an interface.

func (*UpdateTeamRoleMetaUpdateTeamRole) GetNodeId added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) GetNodeId() string

GetNodeId returns UpdateTeamRoleMetaUpdateTeamRole.NodeId, and is useful for accessing the field via an interface.

func (*UpdateTeamRoleMetaUpdateTeamRole) GetRole added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) GetRole() string

GetRole returns UpdateTeamRoleMetaUpdateTeamRole.Role, and is useful for accessing the field via an interface.

func (*UpdateTeamRoleMetaUpdateTeamRole) GetRoleAgent added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) GetRoleAgent() *TeamRoleFieldsRoleAgent

GetRoleAgent returns UpdateTeamRoleMetaUpdateTeamRole.RoleAgent, and is useful for accessing the field via an interface.

func (*UpdateTeamRoleMetaUpdateTeamRole) MarshalJSON added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) MarshalJSON() ([]byte, error)

func (*UpdateTeamRoleMetaUpdateTeamRole) UnmarshalJSON added in v0.9.0 

func (v *UpdateTeamRoleMetaUpdateTeamRole) UnmarshalJSON(b []byte) error

type UpdateTeamSessionResponse added in v0.9.0 

type UpdateTeamSessionResponse struct {
	// #931: update a live session's mutable provenance fields (a PR is usually
	// opened after startSession already ran). Explicit null clears; omitted
	// preserves; an empty update is a valid liveness touch (bumps updatedAt,
	// which liveness counts — #1114). id-only - sessions have no URN.
	// Gate: platform admin, the session's App, or the attributed user (not via
	// impersonation). Updates on an ended session stay allowed (late PR-merge
	// attribution).
	UpdateSession *UpdateTeamSessionUpdateSession `json:"updateSession"`
}

UpdateTeamSessionResponse is returned by UpdateTeamSession on success.

func UpdateTeamSession added in v0.9.0 

func UpdateTeamSession(
	ctx_ context.Context,
	client_ graphql.Client,
	id string,
	prNumber *int,
	branch *string,
) (data_ *UpdateTeamSessionResponse, err_ error)

#931/#932: set a live session's mutable provenance fields mid-session. `session log --pr` denormalizes the PR number here; any authorized update also bumps updatedAt, one of the three inputs the server derives liveness from (hadron-server#1114 retired the inactivity reaper; liveness is computed at read time now, and nothing ends a developer session but an explicit end).

func (*UpdateTeamSessionResponse) GetUpdateSession added in v0.9.0 

func (v *UpdateTeamSessionResponse) GetUpdateSession() *UpdateTeamSessionUpdateSession

GetUpdateSession returns UpdateTeamSessionResponse.UpdateSession, and is useful for accessing the field via an interface.

type UpdateTeamSessionUpdateSession added in v0.9.0 

type UpdateTeamSessionUpdateSession struct {
	TeamSessionFields `json:"-"`
}

UpdateTeamSessionUpdateSession includes the requested fields of the GraphQL type Session. The GraphQL type's documentation follows.

A unit of work recorded against a user or App: the general row, and what the bare word "session" means throughout this schema (#1034). `type` says which kind — DEVELOPER, CHATBOT, AUTOMATION, EDGE — and `workerId` is optional.

A **worker session** is the subtype with `workerId` set: a Worker (named casting) bound to a driver, which is what makes work attributable to a teammate and what a merged PR traces back through. Binding is optional, so a list of these is not a staff view and may hold no worker sessions at all — read `workerId` per row rather than assuming either way.

A **chat session** is NOT one of these and has no row here: it is the conversation a human is in — the Claude Desktop window, the Claude Code session, the IDE chat. The two are independent and **ending one does not end the other**: a chat session that closes leaves its worker session open until endSession. Since #1114 nothing ends it for inactivity — silence is not evidence of abandonment — but it stops reading as LIVE once nobody has driven it inside its idle window, so the stale session stops blocking another bind without being ended or losing its unwritten handoff. That changes no HOLD: a human-held name stays held until explicit release, so only its holder can bind it again. Do not use "chat session" for a Chat (the agent conversation entity) — that is an **agent chat**, a third concept.

func (*UpdateTeamSessionUpdateSession) GetAgentId added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetAgentId() *string

GetAgentId returns UpdateTeamSessionUpdateSession.AgentId, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetAutoExpiredAt added in v0.15.0 

func (v *UpdateTeamSessionUpdateSession) GetAutoExpiredAt() *string

GetAutoExpiredAt returns UpdateTeamSessionUpdateSession.AutoExpiredAt, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetBranch added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetBranch() *string

GetBranch returns UpdateTeamSessionUpdateSession.Branch, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetEndedAt added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetEndedAt() *string

GetEndedAt returns UpdateTeamSessionUpdateSession.EndedAt, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetHost added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetHost() *string

GetHost returns UpdateTeamSessionUpdateSession.Host, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetId added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetId() string

GetId returns UpdateTeamSessionUpdateSession.Id, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetLlmModel added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetLlmModel() *string

GetLlmModel returns UpdateTeamSessionUpdateSession.LlmModel, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetPrNumber added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetPrNumber() *int

GetPrNumber returns UpdateTeamSessionUpdateSession.PrNumber, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetRepo added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetRepo() *string

GetRepo returns UpdateTeamSessionUpdateSession.Repo, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetStartedAt added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetStartedAt() string

GetStartedAt returns UpdateTeamSessionUpdateSession.StartedAt, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetTool added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetTool() *string

GetTool returns UpdateTeamSessionUpdateSession.Tool, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetTranscriptPath added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetTranscriptPath() *string

GetTranscriptPath returns UpdateTeamSessionUpdateSession.TranscriptPath, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetType added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetType() string

GetType returns UpdateTeamSessionUpdateSession.Type, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetUserId added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetUserId() *string

GetUserId returns UpdateTeamSessionUpdateSession.UserId, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetWorker added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetWorker() *TeamSessionFieldsWorker

GetWorker returns UpdateTeamSessionUpdateSession.Worker, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) GetWorkerId added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) GetWorkerId() *string

GetWorkerId returns UpdateTeamSessionUpdateSession.WorkerId, and is useful for accessing the field via an interface.

func (*UpdateTeamSessionUpdateSession) MarshalJSON added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) MarshalJSON() ([]byte, error)

func (*UpdateTeamSessionUpdateSession) UnmarshalJSON added in v0.9.0 

func (v *UpdateTeamSessionUpdateSession) UnmarshalJSON(b []byte) error

type UpdateUserRolesResponse added in v0.9.0 

type UpdateUserRolesResponse struct {
	UpdateUserRoles *UpdateUserRolesUpdateUserRolesUser `json:"updateUserRoles"`
}

UpdateUserRolesResponse is returned by UpdateUserRoles on success.

func UpdateUserRoles added in v0.9.0 

func UpdateUserRoles(
	ctx_ context.Context,
	client_ graphql.Client,
	userId string,
	roles []Role,
) (data_ *UpdateUserRolesResponse, err_ error)

Platform-role administration (#75, descoped from #56). Backs `hadron user set-roles`.

updateUserRoles takes a raw PK — unlike mergeUsers it does NOT resolve a ref server-side — so the CLI resolves the caller's <userRef> to an id first (cmdutil.ResolveUserID) and passes that.

`roles` REPLACES the user's whole role set; the server assigns the list verbatim. The command reads the current set first (via the GetUser query above) so it can show before → after and make that replacement explicit before it happens.

func (*UpdateUserRolesResponse) GetUpdateUserRoles added in v0.9.0 

func (v *UpdateUserRolesResponse) GetUpdateUserRoles() *UpdateUserRolesUpdateUserRolesUser

GetUpdateUserRoles returns UpdateUserRolesResponse.UpdateUserRoles, and is useful for accessing the field via an interface.

type UpdateUserRolesUpdateUserRolesUser added in v0.9.0 

type UpdateUserRolesUpdateUserRolesUser struct {
	UserFields `json:"-"`
}

UpdateUserRolesUpdateUserRolesUser includes the requested fields of the GraphQL type User.

func (*UpdateUserRolesUpdateUserRolesUser) GetEmail added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetEmail() *string

GetEmail returns UpdateUserRolesUpdateUserRolesUser.Email, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetExternalAppId added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetExternalAppId() *string

GetExternalAppId returns UpdateUserRolesUpdateUserRolesUser.ExternalAppId, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetExternalId added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetExternalId() *string

GetExternalId returns UpdateUserRolesUpdateUserRolesUser.ExternalId, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetGithubId added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetGithubId() *int

GetGithubId returns UpdateUserRolesUpdateUserRolesUser.GithubId, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetGithubUsername added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetGithubUsername() *string

GetGithubUsername returns UpdateUserRolesUpdateUserRolesUser.GithubUsername, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetHandle added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetHandle() *string

GetHandle returns UpdateUserRolesUpdateUserRolesUser.Handle, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetId added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetId() string

GetId returns UpdateUserRolesUpdateUserRolesUser.Id, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetIdentityProvider added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetIdentityProvider() *string

GetIdentityProvider returns UpdateUserRolesUpdateUserRolesUser.IdentityProvider, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetLinkedAt added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetLinkedAt() *string

GetLinkedAt returns UpdateUserRolesUpdateUserRolesUser.LinkedAt, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetName added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetName() *string

GetName returns UpdateUserRolesUpdateUserRolesUser.Name, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetRoles added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetRoles() []Role

GetRoles returns UpdateUserRolesUpdateUserRolesUser.Roles, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) GetUrn added in v0.14.0 

func (v *UpdateUserRolesUpdateUserRolesUser) GetUrn() *string

GetUrn returns UpdateUserRolesUpdateUserRolesUser.Urn, and is useful for accessing the field via an interface.

func (*UpdateUserRolesUpdateUserRolesUser) MarshalJSON added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) MarshalJSON() ([]byte, error)

func (*UpdateUserRolesUpdateUserRolesUser) UnmarshalJSON added in v0.9.0 

func (v *UpdateUserRolesUpdateUserRolesUser) UnmarshalJSON(b []byte) error

type UpdateWorkerResponse added in v0.14.0 

type UpdateWorkerResponse struct {
	// #1010 — amend a casting's individuality after the fact.
	//
	// `promptOverride` is the per-worker escape hatch (cor:agt:020:01), but it
	// could only be set at CASTING time — fixing a casting's individuality at the
	// one moment nobody yet knows what makes it individual. The role agent's
	// `systemPrompt` cannot stand in (it is SHARED by every casting of that
	// role), and re-casting is barred by `WORKER_IN_USE` for any worker that has
	// done work — precisely the ones with an identity to record.
	//
	// Scope is one field on purpose: `name` is permanent by law (cor:agt:020:02)
	// and `role`/`agent` define the casting itself. OMITTING promptOverride
	// preserves it; explicit `null` or a blank string CLEARS it, matching the
	// nullable column and castWorker's blank-is-absent normalization.
	//
	// Refuses WORKER_RETIRED for a retired worker: an override is briefing text
	// delivered at bind time, and a retired worker takes no new bindings, so the
	// edit could never reach anyone.
	//
	// Same authorization as castWorker. workerRef is the worker's id or URN (#991).
	UpdateWorker *UpdateWorkerUpdateWorker `json:"updateWorker"`
}

UpdateWorkerResponse is returned by UpdateWorker on success.

func UpdateWorker added in v0.14.0 

func UpdateWorker(
	ctx_ context.Context,
	client_ graphql.Client,
	workerRef string,
	promptOverride *string,
) (data_ *UpdateWorkerResponse, err_ error)

Amend a casting's promptOverride after the fact (#452, server #1010/#1019).

promptOverride could only be set at CASTING time, which fixed a casting's individuality at the one moment nobody yet knows what makes it individual. Neither escape hatch covered it: the role agent's systemPrompt is SHARED by every casting of that role, and re-casting is barred by WORKER_IN_USE for any worker that has done work — precisely the ones with an identity to record.

NO omitempty on $promptOverride, deliberately, and unlike most optional variables in this file. The clear path MUST put an explicit `null` on the wire: omitting the field preserves the current override, so an omitempty here would make `--clear-prompt-override` a silent no-op — the failure the convention-field annotations on UpdateTeamRoleMeta exist to avoid, arriving on a field whose whole point is that it can be removed.

WorkerFields already selects both `prompt` and `promptOverride`, so the receipt can show the RE-RENDERED briefing — what a session driver actually adopts — without a second read.

func (*UpdateWorkerResponse) GetUpdateWorker added in v0.14.0 

func (v *UpdateWorkerResponse) GetUpdateWorker() *UpdateWorkerUpdateWorker

GetUpdateWorker returns UpdateWorkerResponse.UpdateWorker, and is useful for accessing the field via an interface.

type UpdateWorkerUpdateWorker added in v0.14.0 

type UpdateWorkerUpdateWorker struct {
	WorkerFields `json:"-"`
}

UpdateWorkerUpdateWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*UpdateWorkerUpdateWorker) GetAgentId added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetAgentId() string

GetAgentId returns UpdateWorkerUpdateWorker.AgentId, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetAppId added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetAppId() string

GetAppId returns UpdateWorkerUpdateWorker.AppId, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetCreatedAt added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetCreatedAt() string

GetCreatedAt returns UpdateWorkerUpdateWorker.CreatedAt, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetCreatedBy added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetCreatedBy() *string

GetCreatedBy returns UpdateWorkerUpdateWorker.CreatedBy, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetHasLiveSession added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetHasLiveSession() *bool

GetHasLiveSession returns UpdateWorkerUpdateWorker.HasLiveSession, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetHeldAt added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetHeldAt() *string

GetHeldAt returns UpdateWorkerUpdateWorker.HeldAt, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetHeldByUserId added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetHeldByUserId() *string

GetHeldByUserId returns UpdateWorkerUpdateWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetId added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetId() string

GetId returns UpdateWorkerUpdateWorker.Id, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetLastActiveAt added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetLastActiveAt() *string

GetLastActiveAt returns UpdateWorkerUpdateWorker.LastActiveAt, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetMemoryId added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetMemoryId() *string

GetMemoryId returns UpdateWorkerUpdateWorker.MemoryId, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetName added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetName() string

GetName returns UpdateWorkerUpdateWorker.Name, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetPortalUrl added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetPortalUrl() *string

GetPortalUrl returns UpdateWorkerUpdateWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetPrompt added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetPrompt() *string

GetPrompt returns UpdateWorkerUpdateWorker.Prompt, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetPromptOverride added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetPromptOverride() *string

GetPromptOverride returns UpdateWorkerUpdateWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetRepos added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetRepos() []string

GetRepos returns UpdateWorkerUpdateWorker.Repos, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetRetiredAt added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetRetiredAt() *string

GetRetiredAt returns UpdateWorkerUpdateWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetRetiredBy added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetRetiredBy() *string

GetRetiredBy returns UpdateWorkerUpdateWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetRole added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetRole() *string

GetRole returns UpdateWorkerUpdateWorker.Role, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetSlug added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetSlug() string

GetSlug returns UpdateWorkerUpdateWorker.Slug, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) GetUrn added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) GetUrn() *string

GetUrn returns UpdateWorkerUpdateWorker.Urn, and is useful for accessing the field via an interface.

func (*UpdateWorkerUpdateWorker) MarshalJSON added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) MarshalJSON() ([]byte, error)

func (*UpdateWorkerUpdateWorker) UnmarshalJSON added in v0.14.0 

func (v *UpdateWorkerUpdateWorker) UnmarshalJSON(b []byte) error

type UploadIntent added in v0.9.0 

type UploadIntent string
const (
	UploadIntentAgentRequest UploadIntent = "AGENT_REQUEST"
	UploadIntentUser         UploadIntent = "USER"
)

type UserApiKeyFields added in v0.3.0 

type UserApiKeyFields struct {
	Id         string  `json:"id"`
	Label      *string `json:"label"`
	KeyPreview string  `json:"keyPreview"`
	// Issuance path: portal (createUserApiKey) or oauth:<client_id>
	// (POST /oauth/token). Powers source labels in the revocation UI.
	IssuedVia  *string `json:"issuedVia"`
	CreatedAt  string  `json:"createdAt"`
	LastUsedAt *string `json:"lastUsedAt"`
	RevokedAt  *string `json:"revokedAt"`
}

UserApiKeyFields includes the GraphQL fields of UserApiKey requested by the fragment UserApiKeyFields. The GraphQL type's documentation follows.

025-oauth-for-mcp: user-scoped bearer-token credential. Mirrors the AppKey shape but resolves to a User instead of an App. Surfaced to the portal revocation UI (Phase 3) so users can audit + revoke their own keys. userId is intentionally absent — for self-service v1 the caller is always the owner; admin-tooling auditability is out of scope (see contracts/graphql-mutations.md, PR-137 delta D1).

func (*UserApiKeyFields) GetCreatedAt added in v0.3.0 

func (v *UserApiKeyFields) GetCreatedAt() string

GetCreatedAt returns UserApiKeyFields.CreatedAt, and is useful for accessing the field via an interface.

func (*UserApiKeyFields) GetId added in v0.3.0 

func (v *UserApiKeyFields) GetId() string

GetId returns UserApiKeyFields.Id, and is useful for accessing the field via an interface.

func (*UserApiKeyFields) GetIssuedVia added in v0.3.0 

func (v *UserApiKeyFields) GetIssuedVia() *string

GetIssuedVia returns UserApiKeyFields.IssuedVia, and is useful for accessing the field via an interface.

func (*UserApiKeyFields) GetKeyPreview added in v0.3.0 

func (v *UserApiKeyFields) GetKeyPreview() string

GetKeyPreview returns UserApiKeyFields.KeyPreview, and is useful for accessing the field via an interface.

func (*UserApiKeyFields) GetLabel added in v0.3.0 

func (v *UserApiKeyFields) GetLabel() *string

GetLabel returns UserApiKeyFields.Label, and is useful for accessing the field via an interface.

func (*UserApiKeyFields) GetLastUsedAt added in v0.3.0 

func (v *UserApiKeyFields) GetLastUsedAt() *string

GetLastUsedAt returns UserApiKeyFields.LastUsedAt, and is useful for accessing the field via an interface.

func (*UserApiKeyFields) GetRevokedAt added in v0.3.0 

func (v *UserApiKeyFields) GetRevokedAt() *string

GetRevokedAt returns UserApiKeyFields.RevokedAt, and is useful for accessing the field via an interface.

type UserFields added in v0.3.0 

type UserFields struct {
	Id string `json:"id"`
	// Canonical `hrn:user:<handle>` URN (spec cor:urn:010:01). Computed from the
	// handle; null for a handle-less user (who has no URN).
	Urn            *string `json:"urn"`
	Name           *string `json:"name"`
	Email          *string `json:"email"`
	Handle         *string `json:"handle"`
	GithubUsername *string `json:"githubUsername"`
	// Platform roles; an empty list is returned to viewers without personal-field access.
	Roles []Role `json:"roles"`
	// Account metadata, visible to self, platform admins, and co-members.
	IdentityProvider *string `json:"identityProvider"`
	GithubId         *int    `json:"githubId"`
	ExternalId       *string `json:"externalId"`
	ExternalAppId    *string `json:"externalAppId"`
	LinkedAt         *string `json:"linkedAt"`
}

The identity fields (identityProvider/githubId/externalId/externalAppId) are load-bearing for duplicate-account triage: `user merge` folds a source-only value into an EMPTY target field only, so a populated collision is cleared from the source and that login stops working. Seeing both sides' providers is what tells a merge apart from a lockout (cor:api:010:02).

func (*UserFields) GetEmail added in v0.3.0 

func (v *UserFields) GetEmail() *string

GetEmail returns UserFields.Email, and is useful for accessing the field via an interface.

func (*UserFields) GetExternalAppId added in v0.9.0 

func (v *UserFields) GetExternalAppId() *string

GetExternalAppId returns UserFields.ExternalAppId, and is useful for accessing the field via an interface.

func (*UserFields) GetExternalId added in v0.9.0 

func (v *UserFields) GetExternalId() *string

GetExternalId returns UserFields.ExternalId, and is useful for accessing the field via an interface.

func (*UserFields) GetGithubId added in v0.9.0 

func (v *UserFields) GetGithubId() *int

GetGithubId returns UserFields.GithubId, and is useful for accessing the field via an interface.

func (*UserFields) GetGithubUsername added in v0.3.0 

func (v *UserFields) GetGithubUsername() *string

GetGithubUsername returns UserFields.GithubUsername, and is useful for accessing the field via an interface.

func (*UserFields) GetHandle added in v0.3.0 

func (v *UserFields) GetHandle() *string

GetHandle returns UserFields.Handle, and is useful for accessing the field via an interface.

func (*UserFields) GetId added in v0.3.0 

func (v *UserFields) GetId() string

GetId returns UserFields.Id, and is useful for accessing the field via an interface.

func (*UserFields) GetIdentityProvider added in v0.9.0 

func (v *UserFields) GetIdentityProvider() *string

GetIdentityProvider returns UserFields.IdentityProvider, and is useful for accessing the field via an interface.

func (*UserFields) GetLinkedAt added in v0.9.0 

func (v *UserFields) GetLinkedAt() *string

GetLinkedAt returns UserFields.LinkedAt, and is useful for accessing the field via an interface.

func (*UserFields) GetName added in v0.3.0 

func (v *UserFields) GetName() *string

GetName returns UserFields.Name, and is useful for accessing the field via an interface.

func (*UserFields) GetRoles added in v0.3.0 

func (v *UserFields) GetRoles() []Role

GetRoles returns UserFields.Roles, and is useful for accessing the field via an interface.

func (*UserFields) GetUrn added in v0.14.0 

func (v *UserFields) GetUrn() *string

GetUrn returns UserFields.Urn, and is useful for accessing the field via an interface.

type ValidateMemoryResponse added in v0.9.0 

type ValidateMemoryResponse struct {
	// Memory health audit (#819) — the GraphQL twin of hadron_validate, which was
	// MCP-only, so the CLI, the portal and CI had no way to answer "is this
	// memory healthy?".
	//
	// Every check is over server-owned state a client cannot compute:
	// abstractOriginHash vs current content, embedding_failed_at (not projected
	// on Node at all), and property-schema conformance. So unlike other gaps
	// there is no slow client-side fallback.
	//
	// Returns TYPED findings so a caller can branch and CI can gate on
	// totalFindings. findings is capped by limit (default 200, max 1000) while
	// totalFindings reports the true count - so a gate is never fooled by
	// truncation. Read gate as the rest of the memory reads.
	ValidateMemory *ValidateMemoryValidateMemoryMemoryValidationResult `json:"validateMemory"`
}

ValidateMemoryResponse is returned by ValidateMemory on success.

func ValidateMemory added in v0.9.0 

func ValidateMemory(
	ctx_ context.Context,
	client_ graphql.Client,
	memoryRef string,
	limit *int,
) (data_ *ValidateMemoryResponse, err_ error)

Memory health audit (hadron-server#819) — the GraphQL twin of the MCP-only hadron_validate, wired up for `hadron memory validate` (#352).

Two fields exist because `findings` is NOT the answer on its own: - totalFindings is the true count BEFORE `limit` truncation — gate CI on this, never on len(findings). - ok is false when any check was SKIPPED, even with zero findings, so a clean bill of health can't quietly omit a check. skippedChecks says which and why (e.g. the stale-abstract check is skipped on encrypted memories: the validator does not decrypt).

The server takes no per-check filter, so --check narrows client-side; the command surfaces the interaction with truncation rather than hiding it.

func (*ValidateMemoryResponse) GetValidateMemory added in v0.9.0 

func (v *ValidateMemoryResponse) GetValidateMemory() *ValidateMemoryValidateMemoryMemoryValidationResult

GetValidateMemory returns ValidateMemoryResponse.ValidateMemory, and is useful for accessing the field via an interface.

type ValidateMemoryValidateMemoryMemoryValidationResult added in v0.9.0 

type ValidateMemoryValidateMemoryMemoryValidationResult struct {
	MemoryId string `json:"memoryId"`
	// Live (non-deleted) nodes scanned - soft-deleted tombstones are excluded, since their findings would be unactionable (#884). The whole memory in one pass - the checks are cross-referential, so a partial scan would produce false positives rather than fewer findings.
	NodesChecked int `json:"nodesChecked"`
	// True only when EVERY check ran and none found anything. A skipped check
	// makes this false even with zero findings - you cannot claim health for a
	// check you did not run.
	Ok bool `json:"ok"`
	// The TRUE finding count, before any truncation - gate CI on this, not on findings.length.
	TotalFindings int `json:"totalFindings"`
	// True when findings was capped and totalFindings is larger.
	Truncated bool `json:"truncated"`
	// Findings, capped by the limit argument.
	Findings      []*ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding           `json:"findings"`
	SkippedChecks []*ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck `json:"skippedChecks"`
}

ValidateMemoryValidateMemoryMemoryValidationResult includes the requested fields of the GraphQL type MemoryValidationResult.

func (*ValidateMemoryValidateMemoryMemoryValidationResult) GetFindings added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResult) GetFindings() []*ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding

GetFindings returns ValidateMemoryValidateMemoryMemoryValidationResult.Findings, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResult) GetMemoryId added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResult) GetMemoryId() string

GetMemoryId returns ValidateMemoryValidateMemoryMemoryValidationResult.MemoryId, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResult) GetNodesChecked added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResult) GetNodesChecked() int

GetNodesChecked returns ValidateMemoryValidateMemoryMemoryValidationResult.NodesChecked, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResult) GetOk added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResult) GetOk() bool

GetOk returns ValidateMemoryValidateMemoryMemoryValidationResult.Ok, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResult) GetSkippedChecks added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResult) GetSkippedChecks() []*ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck

GetSkippedChecks returns ValidateMemoryValidateMemoryMemoryValidationResult.SkippedChecks, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResult) GetTotalFindings added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResult) GetTotalFindings() int

GetTotalFindings returns ValidateMemoryValidateMemoryMemoryValidationResult.TotalFindings, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResult) GetTruncated added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResult) GetTruncated() bool

GetTruncated returns ValidateMemoryValidateMemoryMemoryValidationResult.Truncated, and is useful for accessing the field via an interface.

type ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding added in v0.9.0 

type ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding struct {
	Kind    MemoryValidationCheck `json:"kind"`
	NodeId  string                `json:"nodeId"`
	NodeLoc string                `json:"nodeLoc"`
	NodeUrn *string               `json:"nodeUrn"`
	Detail  string                `json:"detail"`
}

ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding includes the requested fields of the GraphQL type MemoryValidationFinding. The GraphQL type's documentation follows.

One finding (#819). nodeUrn is null when the URN could not be composed - a memory URN the flat v2 shape cannot express, or an unexpected/legacy loc - in which case nodeId and nodeLoc still identify the node.

func (*ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetDetail added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetDetail() string

GetDetail returns ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding.Detail, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetKind added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetKind() MemoryValidationCheck

GetKind returns ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding.Kind, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetNodeId added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetNodeId() string

GetNodeId returns ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding.NodeId, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetNodeLoc added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetNodeLoc() string

GetNodeLoc returns ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding.NodeLoc, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetNodeUrn added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding) GetNodeUrn() *string

GetNodeUrn returns ValidateMemoryValidateMemoryMemoryValidationResultFindingsMemoryValidationFinding.NodeUrn, and is useful for accessing the field via an interface.

type ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck added in v0.9.0 

type ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck struct {
	Check  MemoryValidationCheck `json:"check"`
	Reason string                `json:"reason"`
}

ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck includes the requested fields of the GraphQL type MemoryValidationSkippedCheck. The GraphQL type's documentation follows.

A check that could NOT run (#819). Reported explicitly rather than silently omitted: a clean bill of health that quietly skipped a check is worse than no report at all.

func (*ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck) GetCheck added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck) GetCheck() MemoryValidationCheck

GetCheck returns ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck.Check, and is useful for accessing the field via an interface.

func (*ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck) GetReason added in v0.9.0 

func (v *ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck) GetReason() string

GetReason returns ValidateMemoryValidateMemoryMemoryValidationResultSkippedChecksMemoryValidationSkippedCheck.Reason, and is useful for accessing the field via an interface.

type VerifyNodeResponse added in v0.19.0 

type VerifyNodeResponse struct {
	// #1591 — the tamper check: recompute the node's approval hash from its current title/abstract/content and compare it with the approval on record. A pure read; an encrypted memory needs its session key (SESSION_EXPIRED otherwise).
	VerifyNode *VerifyNodeVerifyNodeNodeIntegrityCheck `json:"verifyNode"`
}

VerifyNodeResponse is returned by VerifyNode on success.

func VerifyNode added in v0.19.0 

func VerifyNode(
	ctx_ context.Context,
	client_ graphql.Client,
	nodeRef string,
) (data_ *VerifyNodeResponse, err_ error)

func (*VerifyNodeResponse) GetVerifyNode added in v0.19.0 

func (v *VerifyNodeResponse) GetVerifyNode() *VerifyNodeVerifyNodeNodeIntegrityCheck

GetVerifyNode returns VerifyNodeResponse.VerifyNode, and is useful for accessing the field via an interface.

type VerifyNodeVerifyNodeNodeIntegrityCheck added in v0.19.0 

type VerifyNodeVerifyNodeNodeIntegrityCheck struct {
	NodeId string             `json:"nodeId"`
	Urn    string             `json:"urn"`
	Loc    string             `json:"loc"`
	State  NodeIntegrityState `json:"state"`
	// The current revision.
	Revision         int  `json:"revision"`
	ApprovedRevision *int `json:"approvedRevision"`
	// The approval hash on record.
	ExpectedHash *string `json:"expectedHash"`
	// The approval hash recomputed from the current title/abstract/content.
	ActualHash string `json:"actualHash"`
}

VerifyNodeVerifyNodeNodeIntegrityCheck includes the requested fields of the GraphQL type NodeIntegrityCheck. The GraphQL type's documentation follows.

#1591 — one node's tamper check.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetActualHash added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetActualHash() string

GetActualHash returns VerifyNodeVerifyNodeNodeIntegrityCheck.ActualHash, and is useful for accessing the field via an interface.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetApprovedRevision added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetApprovedRevision() *int

GetApprovedRevision returns VerifyNodeVerifyNodeNodeIntegrityCheck.ApprovedRevision, and is useful for accessing the field via an interface.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetExpectedHash added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetExpectedHash() *string

GetExpectedHash returns VerifyNodeVerifyNodeNodeIntegrityCheck.ExpectedHash, and is useful for accessing the field via an interface.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetLoc added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetLoc() string

GetLoc returns VerifyNodeVerifyNodeNodeIntegrityCheck.Loc, and is useful for accessing the field via an interface.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetNodeId added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetNodeId() string

GetNodeId returns VerifyNodeVerifyNodeNodeIntegrityCheck.NodeId, and is useful for accessing the field via an interface.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetRevision added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetRevision() int

GetRevision returns VerifyNodeVerifyNodeNodeIntegrityCheck.Revision, and is useful for accessing the field via an interface.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetState added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetState() NodeIntegrityState

GetState returns VerifyNodeVerifyNodeNodeIntegrityCheck.State, and is useful for accessing the field via an interface.

func (*VerifyNodeVerifyNodeNodeIntegrityCheck) GetUrn added in v0.19.0 

func (v *VerifyNodeVerifyNodeNodeIntegrityCheck) GetUrn() string

GetUrn returns VerifyNodeVerifyNodeNodeIntegrityCheck.Urn, and is useful for accessing the field via an interface.

type WorkerContinuityStatus added in v0.18.0 

type WorkerContinuityStatus string

#1029. MISSING is deliberately not "no handoff": it means the PREVIOUS stint did not write one, while `handoff` may still carry an older record. Silently presenting a stale handoff as current is the failure this distinction exists to prevent. 

const (
	// The previous session wrote the handoff returned here.
	WorkerContinuityStatusCurrent WorkerContinuityStatus = "CURRENT"
	// No previous ended session — nothing to inherit, and that is not a gap.
	WorkerContinuityStatusFirstStint WorkerContinuityStatus = "FIRST_STINT"
	// The previous session ended, or was auto-expired, without writing one.
	WorkerContinuityStatusMissing WorkerContinuityStatus = "MISSING"
)

type WorkerFields added in v0.9.0 

type WorkerFields struct {
	Id string `json:"id"`
	// hrn:worker:<root>:<app-slug>:<slug> (#991) — computed from the App's URN
	// plus `slug`, not stored. Accepted anywhere a workerRef is taken, and
	// resolvable via Query.resolveUrn, so a client can address a worker without
	// holding its id. Null only when the App's URN predates the flat grammar-v2
	// shape this arity requires.
	Urn *string `json:"urn"`
	// #1026 — the portal link that opens this worker, mirroring Node.portalUrl
	// (#881), so a worker signing an artifact under #1008 hands over a URL
	// instead of assembling one out of a URN spelling the /app/u route may not
	// resolve.
	//
	// Built from the SAME URN the urn field returns, so the two cannot diverge.
	// Null on both arms and neither is an error: no configured portal origin
	// means no link (a link to the wrong host is worse than none), and an App URN
	// the fixed arity cannot take means no URN to build one from.
	PortalUrl *string `json:"portalUrl"`
	// The URN atom, derived from the name at cast time and permanent thereafter
	// (#991). Lowercased, sanitized to the URN slug charset, and iterated
	// ('iris', 'iris-2', …) until free within the App — so deriving it NEVER
	// refuses a cast, and the name collision stays the only allocation failure a
	// caller sees (cor:agt:020:02).
	Slug    string `json:"slug"`
	AppId   string `json:"appId"`
	AgentId string `json:"agentId"`
	// The worker's name ('Iris') — the identity every surface renders.
	Name string `json:"name"`
	// The cast-list role this filling answers ('backend-engineer').
	Role *string `json:"role"`
	// The worker's boot prompt, resolved: the agent's systemPrompt template
	// with {{name}}/{{role}} bound, then promptOverride appended as its own
	// paragraph. Null when the agent carries no template and the worker no
	// override.
	Prompt *string `json:"prompt"`
	// Per-worker individuality layered over the agent's template prompt.
	PromptOverride *string `json:"promptOverride"`
	// #1024 — the repo affinity of this worker's ROLE, resolved so a client that
	// already holds the worker needs no second round-trip to teamRoles. The CLI
	// warns on a role/repo mismatch at session start (hadron-cli#456).
	//
	// WORKING-STATE field: behind the worker read gate and masked to [] on deny,
	// like promptOverride and the holder — Session.worker reaches a Worker
	// through a wider gate that admits any org member and survives a user leaving
	// the App, so an ungated field would publish a team's repo list through any
	// historical session.
	//
	// Masking to [] costs nothing, because empty already means "no affinity,
	// never warn": a denied caller simply gets no warning, which is the safe
	// direction for a signal that must never become a refusal. Same reason a
	// worker with no role, a role with no definition, or an unreadable system
	// memory all answer [] rather than erroring.
	Repos []string `json:"repos"`
	// The worker-scoped working memory in the App's container (null until provisioned).
	MemoryId *string `json:"memoryId"`
	// #1050 — the human HOLDING this name, or null when nobody does.
	//
	// A name is held by a person, not by a live session: expiry, a reap, or a
	// closed chat session never free it, and only an explicit release does. This
	// is what separates the two meanings of "taken" — HELD is whose name it is,
	// while a live session is only ever a question about your own worker.
	//
	// WORKING-STATE field, behind the worker read gate and masked to null on
	// deny — like promptOverride and memoryId, and NOT like name/role/urn.
	// Session.worker reaches a Worker row through a wider gate that admits any
	// org member and survives a user leaving the App, so an ungated holder would
	// let a former member read current staffing off a historical session.
	HeldByUserId *string `json:"heldByUserId"`
	// When the current hold was taken. Null exactly when heldByUserId is — and
	// likewise masked on deny.
	//
	// #1034: "taken" here is the HOLD's timestamp, unrelated to `WORKER_TAKEN`
	// (a live worker session) and to `TeamRoleName.taken` (a name allocated in
	// the register). Three senses of one word across two types.
	HeldAt *string `json:"heldAt"`
	// hadron-cli#487 — whether anyone is DRIVING this name right now.
	//
	// Not availability: availability is the HOLD above (`cor:agt:020:09`), and an
	// ended or idle session never frees a name. This says only whether someone is
	// mid-stint, which is the question a coordinator asks about a name already
	// theirs. Conflating the two is the CLI bug this field exists for.
	//
	// #1114 — COMPUTED, never stored. It is "the session has not ended AND it was
	// driven inside its type's idle window", not "a row is open". Nothing ends a
	// session for inactivity any more, because silence is not evidence of
	// abandonment — an agent used once a year is not abandoned in month two — so
	// an open row proves only that nobody closed it. Deriving the answer at read
	// time says exactly what the evidence supports; the previous design expressed
	// the same judgement by ENDING the session, which wrote a guess into the
	// record as a fact and destroyed the handoff that stint had not written yet.
	//
	// A worker that reads false is not gone: its session is untouched, and it
	// reads true again the moment it is driven.
	//
	// Uses the SAME predicate startSession refuses WORKER_TAKEN on
	// (`cor:agt:020:11`) — a reader must not be told a worker is busy that a
	// binder can take, and since #1114 that is load-bearing rather than tidy:
	// with nothing ending abandoned sessions, an `endedAt IS NULL` gate would
	// refuse a bind forever and leave force as the only route.
	//
	// Nullable BECAUSE of the read gate, not because the answer is unknown: this
	// is a working-state field like heldByUserId, masked to null on deny rather
	// than answering false, which would state a fact the server never computed.
	HasLiveSession *bool `json:"hasLiveSession"`
	// hadron-cli#487 — when this worker was last DRIVEN, over every session it has
	// ever had. Null for a worker nobody has ever bound, and that null is the
	// point: a casting nobody picked up renders identically to one worked
	// yesterday on every surface today, so a coordinator can dispatch into a
	// channel no one reads and get no signal at all.
	//
	// The instant is the platform's one derivation of session activity — the
	// greatest of startedAt, updatedAt, and the newest attributed usage event — so
	// it agrees with the takeover prompt and with the idle window hasLiveSession
	// is derived from (#1114: that window DESCRIBES a session, it no longer ends
	// one). Masked to null on deny, like heldByUserId.
	LastActiveAt *string `json:"lastActiveAt"`
	// Retirement instant — a retired worker stops authoring and takes no new sessions; the name stays reserved.
	RetiredAt *string `json:"retiredAt"`
	RetiredBy *string `json:"retiredBy"`
	CreatedAt string  `json:"createdAt"`
	CreatedBy *string `json:"createdBy"`
}

WorkerFields includes the GraphQL fields of Worker requested by the fragment WorkerFields. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*WorkerFields) GetAgentId added in v0.9.0 

func (v *WorkerFields) GetAgentId() string

GetAgentId returns WorkerFields.AgentId, and is useful for accessing the field via an interface.

func (*WorkerFields) GetAppId added in v0.9.0 

func (v *WorkerFields) GetAppId() string

GetAppId returns WorkerFields.AppId, and is useful for accessing the field via an interface.

func (*WorkerFields) GetCreatedAt added in v0.9.0 

func (v *WorkerFields) GetCreatedAt() string

GetCreatedAt returns WorkerFields.CreatedAt, and is useful for accessing the field via an interface.

func (*WorkerFields) GetCreatedBy added in v0.9.0 

func (v *WorkerFields) GetCreatedBy() *string

GetCreatedBy returns WorkerFields.CreatedBy, and is useful for accessing the field via an interface.

func (*WorkerFields) GetHasLiveSession added in v0.13.0 

func (v *WorkerFields) GetHasLiveSession() *bool

GetHasLiveSession returns WorkerFields.HasLiveSession, and is useful for accessing the field via an interface.

func (*WorkerFields) GetHeldAt added in v0.10.0 

func (v *WorkerFields) GetHeldAt() *string

GetHeldAt returns WorkerFields.HeldAt, and is useful for accessing the field via an interface.

func (*WorkerFields) GetHeldByUserId added in v0.10.0 

func (v *WorkerFields) GetHeldByUserId() *string

GetHeldByUserId returns WorkerFields.HeldByUserId, and is useful for accessing the field via an interface.

func (*WorkerFields) GetId added in v0.9.0 

func (v *WorkerFields) GetId() string

GetId returns WorkerFields.Id, and is useful for accessing the field via an interface.

func (*WorkerFields) GetLastActiveAt added in v0.13.0 

func (v *WorkerFields) GetLastActiveAt() *string

GetLastActiveAt returns WorkerFields.LastActiveAt, and is useful for accessing the field via an interface.

func (*WorkerFields) GetMemoryId added in v0.9.0 

func (v *WorkerFields) GetMemoryId() *string

GetMemoryId returns WorkerFields.MemoryId, and is useful for accessing the field via an interface.

func (*WorkerFields) GetName added in v0.9.0 

func (v *WorkerFields) GetName() string

GetName returns WorkerFields.Name, and is useful for accessing the field via an interface.

func (*WorkerFields) GetPortalUrl added in v0.12.0 

func (v *WorkerFields) GetPortalUrl() *string

GetPortalUrl returns WorkerFields.PortalUrl, and is useful for accessing the field via an interface.

func (*WorkerFields) GetPrompt added in v0.9.0 

func (v *WorkerFields) GetPrompt() *string

GetPrompt returns WorkerFields.Prompt, and is useful for accessing the field via an interface.

func (*WorkerFields) GetPromptOverride added in v0.9.0 

func (v *WorkerFields) GetPromptOverride() *string

GetPromptOverride returns WorkerFields.PromptOverride, and is useful for accessing the field via an interface.

func (*WorkerFields) GetRepos added in v0.12.0 

func (v *WorkerFields) GetRepos() []string

GetRepos returns WorkerFields.Repos, and is useful for accessing the field via an interface.

func (*WorkerFields) GetRetiredAt added in v0.9.0 

func (v *WorkerFields) GetRetiredAt() *string

GetRetiredAt returns WorkerFields.RetiredAt, and is useful for accessing the field via an interface.

func (*WorkerFields) GetRetiredBy added in v0.9.0 

func (v *WorkerFields) GetRetiredBy() *string

GetRetiredBy returns WorkerFields.RetiredBy, and is useful for accessing the field via an interface.

func (*WorkerFields) GetRole added in v0.9.0 

func (v *WorkerFields) GetRole() *string

GetRole returns WorkerFields.Role, and is useful for accessing the field via an interface.

func (*WorkerFields) GetSlug added in v0.10.0 

func (v *WorkerFields) GetSlug() string

GetSlug returns WorkerFields.Slug, and is useful for accessing the field via an interface.

func (*WorkerFields) GetUrn added in v0.10.0 

func (v *WorkerFields) GetUrn() *string

GetUrn returns WorkerFields.Urn, and is useful for accessing the field via an interface.

type WorkerRosterFields added in v0.10.0 

type WorkerRosterFields struct {
	Id string `json:"id"`
	// hrn:worker:<root>:<app-slug>:<slug> (#991) — computed from the App's URN
	// plus `slug`, not stored. Accepted anywhere a workerRef is taken, and
	// resolvable via Query.resolveUrn, so a client can address a worker without
	// holding its id. Null only when the App's URN predates the flat grammar-v2
	// shape this arity requires.
	Urn *string `json:"urn"`
	// #1026 — the portal link that opens this worker, mirroring Node.portalUrl
	// (#881), so a worker signing an artifact under #1008 hands over a URL
	// instead of assembling one out of a URN spelling the /app/u route may not
	// resolve.
	//
	// Built from the SAME URN the urn field returns, so the two cannot diverge.
	// Null on both arms and neither is an error: no configured portal origin
	// means no link (a link to the wrong host is worse than none), and an App URN
	// the fixed arity cannot take means no URN to build one from.
	PortalUrl *string `json:"portalUrl"`
	// The URN atom, derived from the name at cast time and permanent thereafter
	// (#991). Lowercased, sanitized to the URN slug charset, and iterated
	// ('iris', 'iris-2', …) until free within the App — so deriving it NEVER
	// refuses a cast, and the name collision stays the only allocation failure a
	// caller sees (cor:agt:020:02).
	Slug    string `json:"slug"`
	AppId   string `json:"appId"`
	AgentId string `json:"agentId"`
	// The worker's name ('Iris') — the identity every surface renders.
	Name string `json:"name"`
	// The cast-list role this filling answers ('backend-engineer').
	Role *string `json:"role"`
	// Per-worker individuality layered over the agent's template prompt.
	PromptOverride *string `json:"promptOverride"`
	// #1024 — the repo affinity of this worker's ROLE, resolved so a client that
	// already holds the worker needs no second round-trip to teamRoles. The CLI
	// warns on a role/repo mismatch at session start (hadron-cli#456).
	//
	// WORKING-STATE field: behind the worker read gate and masked to [] on deny,
	// like promptOverride and the holder — Session.worker reaches a Worker
	// through a wider gate that admits any org member and survives a user leaving
	// the App, so an ungated field would publish a team's repo list through any
	// historical session.
	//
	// Masking to [] costs nothing, because empty already means "no affinity,
	// never warn": a denied caller simply gets no warning, which is the safe
	// direction for a signal that must never become a refusal. Same reason a
	// worker with no role, a role with no definition, or an unreadable system
	// memory all answer [] rather than erroring.
	Repos []string `json:"repos"`
	// The worker-scoped working memory in the App's container (null until provisioned).
	MemoryId *string `json:"memoryId"`
	// #1050 — the human HOLDING this name, or null when nobody does.
	//
	// A name is held by a person, not by a live session: expiry, a reap, or a
	// closed chat session never free it, and only an explicit release does. This
	// is what separates the two meanings of "taken" — HELD is whose name it is,
	// while a live session is only ever a question about your own worker.
	//
	// WORKING-STATE field, behind the worker read gate and masked to null on
	// deny — like promptOverride and memoryId, and NOT like name/role/urn.
	// Session.worker reaches a Worker row through a wider gate that admits any
	// org member and survives a user leaving the App, so an ungated holder would
	// let a former member read current staffing off a historical session.
	HeldByUserId *string `json:"heldByUserId"`
	// When the current hold was taken. Null exactly when heldByUserId is — and
	// likewise masked on deny.
	//
	// #1034: "taken" here is the HOLD's timestamp, unrelated to `WORKER_TAKEN`
	// (a live worker session) and to `TeamRoleName.taken` (a name allocated in
	// the register). Three senses of one word across two types.
	HeldAt *string `json:"heldAt"`
	// hadron-cli#487 — whether anyone is DRIVING this name right now.
	//
	// Not availability: availability is the HOLD above (`cor:agt:020:09`), and an
	// ended or idle session never frees a name. This says only whether someone is
	// mid-stint, which is the question a coordinator asks about a name already
	// theirs. Conflating the two is the CLI bug this field exists for.
	//
	// #1114 — COMPUTED, never stored. It is "the session has not ended AND it was
	// driven inside its type's idle window", not "a row is open". Nothing ends a
	// session for inactivity any more, because silence is not evidence of
	// abandonment — an agent used once a year is not abandoned in month two — so
	// an open row proves only that nobody closed it. Deriving the answer at read
	// time says exactly what the evidence supports; the previous design expressed
	// the same judgement by ENDING the session, which wrote a guess into the
	// record as a fact and destroyed the handoff that stint had not written yet.
	//
	// A worker that reads false is not gone: its session is untouched, and it
	// reads true again the moment it is driven.
	//
	// Uses the SAME predicate startSession refuses WORKER_TAKEN on
	// (`cor:agt:020:11`) — a reader must not be told a worker is busy that a
	// binder can take, and since #1114 that is load-bearing rather than tidy:
	// with nothing ending abandoned sessions, an `endedAt IS NULL` gate would
	// refuse a bind forever and leave force as the only route.
	//
	// Nullable BECAUSE of the read gate, not because the answer is unknown: this
	// is a working-state field like heldByUserId, masked to null on deny rather
	// than answering false, which would state a fact the server never computed.
	HasLiveSession *bool `json:"hasLiveSession"`
	// hadron-cli#487 — when this worker was last DRIVEN, over every session it has
	// ever had. Null for a worker nobody has ever bound, and that null is the
	// point: a casting nobody picked up renders identically to one worked
	// yesterday on every surface today, so a coordinator can dispatch into a
	// channel no one reads and get no signal at all.
	//
	// The instant is the platform's one derivation of session activity — the
	// greatest of startedAt, updatedAt, and the newest attributed usage event — so
	// it agrees with the takeover prompt and with the idle window hasLiveSession
	// is derived from (#1114: that window DESCRIBES a session, it no longer ends
	// one). Masked to null on deny, like heldByUserId.
	LastActiveAt *string `json:"lastActiveAt"`
	// Retirement instant — a retired worker stops authoring and takes no new sessions; the name stays reserved.
	RetiredAt *string `json:"retiredAt"`
	RetiredBy *string `json:"retiredBy"`
	CreatedAt string  `json:"createdAt"`
	CreatedBy *string `json:"createdBy"`
}

The ROSTER projection (#459): WorkerFields minus `prompt`.

`prompt` is the resolved boot briefing — multi-KB per worker. It is a detail of ONE worker, not something you scan a roster for, and the primary consumer of `worker list --json` is an agent piping the output into context. Seven workers meant seven briefings to answer "who is on staff".

This mirrors TeamSessionFields, which already refuses ...WorkerFields for the same reason and says so in its own comment. `worker get` remains the prompt surface, which is what the shipped task nodes already tell readers.

Deliberately KEEPS promptOverride: it is the short per-worker individuality (#1010), not the composed briefing, and dropping it would widen the contract break for no stated benefit.

func (*WorkerRosterFields) GetAgentId added in v0.10.0 

func (v *WorkerRosterFields) GetAgentId() string

GetAgentId returns WorkerRosterFields.AgentId, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetAppId added in v0.10.0 

func (v *WorkerRosterFields) GetAppId() string

GetAppId returns WorkerRosterFields.AppId, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetCreatedAt added in v0.10.0 

func (v *WorkerRosterFields) GetCreatedAt() string

GetCreatedAt returns WorkerRosterFields.CreatedAt, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetCreatedBy added in v0.10.0 

func (v *WorkerRosterFields) GetCreatedBy() *string

GetCreatedBy returns WorkerRosterFields.CreatedBy, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetHasLiveSession added in v0.13.0 

func (v *WorkerRosterFields) GetHasLiveSession() *bool

GetHasLiveSession returns WorkerRosterFields.HasLiveSession, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetHeldAt added in v0.13.0 

func (v *WorkerRosterFields) GetHeldAt() *string

GetHeldAt returns WorkerRosterFields.HeldAt, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetHeldByUserId added in v0.13.0 

func (v *WorkerRosterFields) GetHeldByUserId() *string

GetHeldByUserId returns WorkerRosterFields.HeldByUserId, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetId added in v0.10.0 

func (v *WorkerRosterFields) GetId() string

GetId returns WorkerRosterFields.Id, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetLastActiveAt added in v0.13.0 

func (v *WorkerRosterFields) GetLastActiveAt() *string

GetLastActiveAt returns WorkerRosterFields.LastActiveAt, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetMemoryId added in v0.10.0 

func (v *WorkerRosterFields) GetMemoryId() *string

GetMemoryId returns WorkerRosterFields.MemoryId, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetName added in v0.10.0 

func (v *WorkerRosterFields) GetName() string

GetName returns WorkerRosterFields.Name, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetPortalUrl added in v0.12.0 

func (v *WorkerRosterFields) GetPortalUrl() *string

GetPortalUrl returns WorkerRosterFields.PortalUrl, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetPromptOverride added in v0.10.0 

func (v *WorkerRosterFields) GetPromptOverride() *string

GetPromptOverride returns WorkerRosterFields.PromptOverride, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetRepos added in v0.12.0 

func (v *WorkerRosterFields) GetRepos() []string

GetRepos returns WorkerRosterFields.Repos, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetRetiredAt added in v0.10.0 

func (v *WorkerRosterFields) GetRetiredAt() *string

GetRetiredAt returns WorkerRosterFields.RetiredAt, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetRetiredBy added in v0.10.0 

func (v *WorkerRosterFields) GetRetiredBy() *string

GetRetiredBy returns WorkerRosterFields.RetiredBy, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetRole added in v0.10.0 

func (v *WorkerRosterFields) GetRole() *string

GetRole returns WorkerRosterFields.Role, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetSlug added in v0.10.0 

func (v *WorkerRosterFields) GetSlug() string

GetSlug returns WorkerRosterFields.Slug, and is useful for accessing the field via an interface.

func (*WorkerRosterFields) GetUrn added in v0.10.0 

func (v *WorkerRosterFields) GetUrn() *string

GetUrn returns WorkerRosterFields.Urn, and is useful for accessing the field via an interface.

type WorkersResponse added in v0.9.0 

type WorkersResponse struct {
	// A team App's STAFF (#974, cor:agt:020:01 — Workers are the staff; the
	// AppAgent join is the install roster): the App's castings, oldest first,
	// as a uniform { items, total } page. Retired castings are hidden unless
	// includeRetired. Same authorization as worker. appRef accepts the App's
	// ID or URN.
	Workers *WorkersWorkersWorkersPage `json:"workers"`
}

WorkersResponse is returned by Workers on success.

func Workers added in v0.9.0 

func Workers(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	includeRetired *bool,
	limit *int,
	offset *int,
) (data_ *WorkersResponse, err_ error)

The STAFF read (cor:agt:020:01 — Workers are the staff; the AppAgent join is the install roster, `app agent list`). Retired castings are hidden unless includeRetired.

func (*WorkersResponse) GetWorkers added in v0.9.0 

func (v *WorkersResponse) GetWorkers() *WorkersWorkersWorkersPage

GetWorkers returns WorkersResponse.Workers, and is useful for accessing the field via an interface.

type WorkersRosterResponse added in v0.10.0 

type WorkersRosterResponse struct {
	// A team App's STAFF (#974, cor:agt:020:01 — Workers are the staff; the
	// AppAgent join is the install roster): the App's castings, oldest first,
	// as a uniform { items, total } page. Retired castings are hidden unless
	// includeRetired. Same authorization as worker. appRef accepts the App's
	// ID or URN.
	Workers *WorkersRosterWorkersWorkersPage `json:"workers"`
}

WorkersRosterResponse is returned by WorkersRoster on success.

func WorkersRoster added in v0.10.0 

func WorkersRoster(
	ctx_ context.Context,
	client_ graphql.Client,
	appRef string,
	includeRetired *bool,
	limit *int,
	offset *int,
) (data_ *WorkersRosterResponse, err_ error)

The roster read used by `worker list`. Same arguments and paging as Workers; only the projection differs. Workers itself stays prompt-bearing because resolveWorker rides it — `session start`'s boot briefing, `worker get <name>`, retire and rm all resolve through that scan and legitimately need the prompt.

func (*WorkersRosterResponse) GetWorkers added in v0.10.0 

func (v *WorkersRosterResponse) GetWorkers() *WorkersRosterWorkersWorkersPage

GetWorkers returns WorkersRosterResponse.Workers, and is useful for accessing the field via an interface.

type WorkersRosterWorkersWorkersPage added in v0.10.0 

type WorkersRosterWorkersWorkersPage struct {
	Total int                                           `json:"total"`
	Items []*WorkersRosterWorkersWorkersPageItemsWorker `json:"items"`
}

WorkersRosterWorkersWorkersPage includes the requested fields of the GraphQL type WorkersPage.

func (*WorkersRosterWorkersWorkersPage) GetItems added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPage) GetItems() []*WorkersRosterWorkersWorkersPageItemsWorker

GetItems returns WorkersRosterWorkersWorkersPage.Items, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPage) GetTotal added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPage) GetTotal() int

GetTotal returns WorkersRosterWorkersWorkersPage.Total, and is useful for accessing the field via an interface.

type WorkersRosterWorkersWorkersPageItemsWorker added in v0.10.0 

type WorkersRosterWorkersWorkersPageItemsWorker struct {
	WorkerRosterFields `json:"-"`
}

WorkersRosterWorkersWorkersPageItemsWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetAgentId added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetAgentId() string

GetAgentId returns WorkersRosterWorkersWorkersPageItemsWorker.AgentId, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetAppId added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetAppId() string

GetAppId returns WorkersRosterWorkersWorkersPageItemsWorker.AppId, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetCreatedAt added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetCreatedAt() string

GetCreatedAt returns WorkersRosterWorkersWorkersPageItemsWorker.CreatedAt, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetCreatedBy added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetCreatedBy() *string

GetCreatedBy returns WorkersRosterWorkersWorkersPageItemsWorker.CreatedBy, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetHasLiveSession added in v0.13.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetHasLiveSession() *bool

GetHasLiveSession returns WorkersRosterWorkersWorkersPageItemsWorker.HasLiveSession, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetHeldAt added in v0.13.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetHeldAt() *string

GetHeldAt returns WorkersRosterWorkersWorkersPageItemsWorker.HeldAt, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetHeldByUserId added in v0.13.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetHeldByUserId() *string

GetHeldByUserId returns WorkersRosterWorkersWorkersPageItemsWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetId added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetId() string

GetId returns WorkersRosterWorkersWorkersPageItemsWorker.Id, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetLastActiveAt added in v0.13.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetLastActiveAt() *string

GetLastActiveAt returns WorkersRosterWorkersWorkersPageItemsWorker.LastActiveAt, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetMemoryId added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetMemoryId() *string

GetMemoryId returns WorkersRosterWorkersWorkersPageItemsWorker.MemoryId, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetName added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetName() string

GetName returns WorkersRosterWorkersWorkersPageItemsWorker.Name, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetPortalUrl added in v0.12.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetPortalUrl() *string

GetPortalUrl returns WorkersRosterWorkersWorkersPageItemsWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetPromptOverride added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetPromptOverride() *string

GetPromptOverride returns WorkersRosterWorkersWorkersPageItemsWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetRepos added in v0.12.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetRepos() []string

GetRepos returns WorkersRosterWorkersWorkersPageItemsWorker.Repos, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetRetiredAt added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetRetiredAt() *string

GetRetiredAt returns WorkersRosterWorkersWorkersPageItemsWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetRetiredBy added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetRetiredBy() *string

GetRetiredBy returns WorkersRosterWorkersWorkersPageItemsWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetRole added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetRole() *string

GetRole returns WorkersRosterWorkersWorkersPageItemsWorker.Role, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetSlug added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetSlug() string

GetSlug returns WorkersRosterWorkersWorkersPageItemsWorker.Slug, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) GetUrn added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) GetUrn() *string

GetUrn returns WorkersRosterWorkersWorkersPageItemsWorker.Urn, and is useful for accessing the field via an interface.

func (*WorkersRosterWorkersWorkersPageItemsWorker) MarshalJSON added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) MarshalJSON() ([]byte, error)

func (*WorkersRosterWorkersWorkersPageItemsWorker) UnmarshalJSON added in v0.10.0 

func (v *WorkersRosterWorkersWorkersPageItemsWorker) UnmarshalJSON(b []byte) error

type WorkersWorkersWorkersPage added in v0.9.0 

type WorkersWorkersWorkersPage struct {
	Total int                                     `json:"total"`
	Items []*WorkersWorkersWorkersPageItemsWorker `json:"items"`
}

WorkersWorkersWorkersPage includes the requested fields of the GraphQL type WorkersPage.

func (*WorkersWorkersWorkersPage) GetItems added in v0.9.0 

func (v *WorkersWorkersWorkersPage) GetItems() []*WorkersWorkersWorkersPageItemsWorker

GetItems returns WorkersWorkersWorkersPage.Items, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPage) GetTotal added in v0.9.0 

func (v *WorkersWorkersWorkersPage) GetTotal() int

GetTotal returns WorkersWorkersWorkersPage.Total, and is useful for accessing the field via an interface.

type WorkersWorkersWorkersPageItemsWorker added in v0.9.0 

type WorkersWorkersWorkersPageItemsWorker struct {
	WorkerFields `json:"-"`
}

WorkersWorkersWorkersPageItemsWorker includes the requested fields of the GraphQL type Worker. The GraphQL type's documentation follows.

A Worker (#974, cor:dmo:050:11) — the named casting of an installed Agent into an App: 'Iris', the backend-engineer agent cast into the eng-team App. The Agent carries the reusable persona dressing; the Worker is the local named identity that does attributable work. Names are unique per App, case-insensitively, forever (retirement and uninstall never free them — cor:agt:020:02); rows survive the agent's uninstall. A Worker is addressable by its id or by the computed `urn` below (#991).

func (*WorkersWorkersWorkersPageItemsWorker) GetAgentId added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetAgentId() string

GetAgentId returns WorkersWorkersWorkersPageItemsWorker.AgentId, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetAppId added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetAppId() string

GetAppId returns WorkersWorkersWorkersPageItemsWorker.AppId, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetCreatedAt added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetCreatedAt() string

GetCreatedAt returns WorkersWorkersWorkersPageItemsWorker.CreatedAt, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetCreatedBy added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetCreatedBy() *string

GetCreatedBy returns WorkersWorkersWorkersPageItemsWorker.CreatedBy, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetHasLiveSession added in v0.13.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetHasLiveSession() *bool

GetHasLiveSession returns WorkersWorkersWorkersPageItemsWorker.HasLiveSession, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetHeldAt added in v0.10.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetHeldAt() *string

GetHeldAt returns WorkersWorkersWorkersPageItemsWorker.HeldAt, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetHeldByUserId added in v0.10.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetHeldByUserId() *string

GetHeldByUserId returns WorkersWorkersWorkersPageItemsWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetId added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetId() string

GetId returns WorkersWorkersWorkersPageItemsWorker.Id, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetLastActiveAt added in v0.13.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetLastActiveAt() *string

GetLastActiveAt returns WorkersWorkersWorkersPageItemsWorker.LastActiveAt, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetMemoryId added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetMemoryId() *string

GetMemoryId returns WorkersWorkersWorkersPageItemsWorker.MemoryId, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetName added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetName() string

GetName returns WorkersWorkersWorkersPageItemsWorker.Name, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetPortalUrl added in v0.12.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetPortalUrl() *string

GetPortalUrl returns WorkersWorkersWorkersPageItemsWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetPrompt added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetPrompt() *string

GetPrompt returns WorkersWorkersWorkersPageItemsWorker.Prompt, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetPromptOverride added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetPromptOverride() *string

GetPromptOverride returns WorkersWorkersWorkersPageItemsWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetRepos added in v0.12.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetRepos() []string

GetRepos returns WorkersWorkersWorkersPageItemsWorker.Repos, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetRetiredAt added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetRetiredAt() *string

GetRetiredAt returns WorkersWorkersWorkersPageItemsWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetRetiredBy added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetRetiredBy() *string

GetRetiredBy returns WorkersWorkersWorkersPageItemsWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetRole added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetRole() *string

GetRole returns WorkersWorkersWorkersPageItemsWorker.Role, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetSlug added in v0.10.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetSlug() string

GetSlug returns WorkersWorkersWorkersPageItemsWorker.Slug, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) GetUrn added in v0.10.0 

func (v *WorkersWorkersWorkersPageItemsWorker) GetUrn() *string

GetUrn returns WorkersWorkersWorkersPageItemsWorker.Urn, and is useful for accessing the field via an interface.

func (*WorkersWorkersWorkersPageItemsWorker) MarshalJSON added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) MarshalJSON() ([]byte, error)

func (*WorkersWorkersWorkersPageItemsWorker) UnmarshalJSON added in v0.9.0 

func (v *WorkersWorkersWorkersPageItemsWorker) UnmarshalJSON(b []byte) error

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.