gen

package
v0.12.0 Latest Latest
Warning

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

 Go to latest Published: Aug 24, 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 = `` /* 321-byte string literal not displayed */

The mutation executed by AddOrgMember.

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 = `` /* 407-byte string literal not displayed */

The query executed by Agents.

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 Apps_Operation = `` /* 208-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 = `` /* 440-byte string literal not displayed */

The mutation executed by CastWorker.

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 = `` /* 259-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 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 = `` /* 730-byte string literal not displayed */

The mutation executed by CreateAgent.

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 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 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 CreateNode_Operation = `` /* 162-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 CreateSecret_Operation = `` /* 398-byte string literal not displayed */

The mutation executed by CreateSecret.

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 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 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 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 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 = `` /* 357-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 = `` /* 454-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 = `` /* 282-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 GetInvitation_Operation = `` /* 277-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 GetNode_Operation = `` /* 478-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 GetTeamSession_Operation = `` /* 277-byte string literal not displayed */

The query executed by GetTeamSession.

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

The query executed by GetUser.

View Source 
const GetWorker_Operation = `` /* 273-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 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 = `` /* 413-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 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 = `` /* 156-byte string literal not displayed */

The mutation executed by MergeNodes.

View Source 
const MergeUsers_Operation = `` /* 281-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 MoveNode_Operation = `` /* 257-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 = `` /* 695-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 NodeRevision_Operation = `` /* 292-byte string literal not displayed */

The query executed by NodeRevision.

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

The query executed by NodeRevisions.

View Source 
const OrgMembers_Operation = `` /* 291-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 = `` /* 398-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 RecordTeamWork_Operation = `` /* 427-byte string literal not displayed */

The mutation executed by RecordTeamWork.

View Source 
const ReleaseWorker_Operation = `` /* 305-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 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 = `` /* 303-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 SearchNodes_Operation = `` /* 468-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 SearchUsers_Operation = `` /* 320-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 ServerInfo_Operation = `
query ServerInfo {
	serverInfo {
		version
		baseUrl
	}
}
`

The query executed by ServerInfo.

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

The mutation executed by SoftDeleteAsset.

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

The mutation executed by StartImpersonation.

View Source 
const StartTeamSession_Operation = `` /* 306-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 TeamChatMessages_Operation = `` /* 427-byte string literal not displayed */

The query executed by TeamChatMessages.

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 = `` /* 387-byte string literal not displayed */

The query executed by TeamSessions.

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

The query executed by TeamWorkItems.

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 UpdateAgentSchedule_Operation = `` /* 372-byte string literal not displayed */

The mutation executed by UpdateAgentSchedule.

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

The mutation executed by UpdateAgent.

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

The mutation executed by UpdateAiServiceConfig.

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 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 = `` /* 308-byte string literal not displayed */

The mutation executed by UpdateMyProfile.

View Source 
const UpdateNodeData_Operation = `` /* 218-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 UpdateNode_Operation = `` /* 156-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 = `` /* 327-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 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 = `` /* 360-byte string literal not displayed */

The mutation executed by UpdateTeamSession.

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

The mutation executed by UpdateUserRoles.

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

The query executed by ValidateMemory.

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

The query executed by WorkersRoster.

View Source 
const Workers_Operation = `` /* 422-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 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 AllMemoryMemberRole = []MemoryMemberRole{
	MemoryMemberRoleOwner,
	MemoryMemberRoleReader,
	MemoryMemberRoleWriter,
}
View Source 
var AllMemoryShareRole = []MemoryShareRole{
	MemoryShareRoleReader,
	MemoryShareRoleWriter,
}
View Source 
var AllMemoryValidationCheck = []MemoryValidationCheck{
	MemoryValidationCheckBrokenRef,
	MemoryValidationCheckEmbedFailed,
	MemoryValidationCheckSchema,
	MemoryValidationCheckSparse,
	MemoryValidationCheckStaleAbstract,
}
View Source 
var AllMemoryVisibility = []MemoryVisibility{
	MemoryVisibilityGroup,
	MemoryVisibilityOrganization,
	MemoryVisibilityPublic,
}
View Source 
var AllNodeExportFormat = []NodeExportFormat{
	NodeExportFormatJson,
	NodeExportFormatMd,
	NodeExportFormatPdf,
}
View Source 
var AllNodeMergeField = []NodeMergeField{
	NodeMergeFieldAbstract,
	NodeMergeFieldContent,
	NodeMergeFieldData,
	NodeMergeFieldDescription,
	NodeMergeFieldEdges,
	NodeMergeFieldProperties,
	NodeMergeFieldTags,
}
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 AllRole = []Role{
	RoleAdmin,
	RoleContributor,
	RoleOwner,
	RoleReader,
}
View Source 
var AllSyncStatus = []SyncStatus{
	SyncStatusError,
	SyncStatusOk,
	SyncStatusPending,
	SyncStatusSyncing,
}
View Source 
var AllUploadIntent = []UploadIntent{
	UploadIntentAgentRequest,
	UploadIntentUser,
}

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.

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) 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 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"`
	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"`
	// Persona identity TEMPLATE ('You are {{name}}, ...'); {{name}}/{{role}} are bound at casting time (Worker.prompt returns the bound result).
	PersonaPrompt *string `json:"personaPrompt"`
	CreatedAt     string  `json:"createdAt"`
}

AgentFields includes the GraphQL fields of Agent requested by the fragment AgentFields.

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) GetPersonaPrompt added in v0.9.0 

func (v *AgentFields) GetPersonaPrompt() *string

GetPersonaPrompt returns AgentFields.PersonaPrompt, 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"`
	Type       *AgentType       `json:"type"`
	Visibility *AgentVisibility `json:"visibility"`
}

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.

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) GetPersonaPrompt added in v0.9.0 

func (v *AgentsAgentsAgentsPageItemsAgent) GetPersonaPrompt() *string

GetPersonaPrompt returns AgentsAgentsAgentsPageItemsAgent.PersonaPrompt, 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 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; v1 known: 'anthropic' | 'openai' | 'glm' | 'bedrock'.
	Provider string `json:"provider"`
	// Model identifier, passed verbatim to the provider.
	Model     string `json:"model"`
	HasApiKey bool   `json:"hasApiKey"`
	// Ellipsis + last 4 characters of the stored key; null when no key.
	ApiKeyPreview *string `json:"apiKeyPreview"`
	// Provider-specific knobs (maxTokens, thinking, effort, baseUrl, ...).
	Params *json.RawMessage `json:"params"`
	// Disabled configs are skipped by resolution (the walk continues outward).
	Enabled   bool    `json:"enabled"`
	CreatedAt string  `json:"createdAt"`
	UpdatedAt *string `json:"updatedAt"`
}

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 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.

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.

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 AppRunAppRun added in v0.6.0 

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

AppRunAppRun includes the requested fields of the GraphQL type AppRun.

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.

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).
	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.

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 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"`
	AgentId     *string `json:"agentId"`
	MemberCount int     `json:"memberCount"`
	CreatedAt   string  `json:"createdAt"`
}

AppsAppsAppsPageItemsApp includes the requested fields of the GraphQL type App.

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,
	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.

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 {
	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"`
	Class            MemoryClass       `json:"class"`
	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.

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 {
	PrincipalType PrincipalType                                         `json:"principalType"`
	AppId         *string                                               `json:"appId"`
	AgentId       *string                                               `json:"agentId"`
	User          *AuthContextAuthContextUser                           `json:"user"`
	ApiKey        *AuthContextAuthContextApiKeyUserApiKey               `json:"apiKey"`
	Impersonation *AuthContextAuthContextImpersonationImpersonationInfo `json:"impersonation"`
}

AuthContextAuthContext includes the requested fields of the GraphQL type AuthContext.

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.

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"`
	ReadOnly       bool                                                           `json:"readOnly"`
	ActorUser      *AuthContextAuthContextImpersonationImpersonationInfoActorUser `json:"actorUser"`
}

AuthContextAuthContextImpersonationImpersonationInfo includes the requested fields of the GraphQL type ImpersonationInfo.

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"`
	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 {
	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.

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) 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) 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 personaPrompt 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 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 {
	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"`
	Class            MemoryClass       `json:"class"`
	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.

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"`
	NodeType   string   `json:"nodeType"`
	Tags       []string `json:"tags"`
	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) 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 {
	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 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.
	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 CreateAgentCreateAgent added in v0.7.0 

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

CreateAgentCreateAgent includes the requested fields of the GraphQL type Agent.

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) GetPersonaPrompt added in v0.9.0 

func (v *CreateAgentCreateAgent) GetPersonaPrompt() *string

GetPersonaPrompt returns CreateAgentCreateAgent.PersonaPrompt, 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 / personaPrompt are the persona dressing (cor:agt:020:01) —
	// the reusable role plus the '{{name}}'-templated identity 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,
	personaPrompt *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"`
	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) 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"`
}

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.

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: omitted = stored without a key (unusable for
	// execution until one is set); non-empty = encrypted at rest with a
	// masked preview. 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 CreateAppCreateApp 

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

CreateAppCreateApp includes the requested fields of the GraphQL type App.

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

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"`
	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 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}; 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"`
	Name       *string `json:"name"`
	Loc        string  `json:"loc"`
	IsRunnable *bool   `json:"isRunnable"`
	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.

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 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"`
	Class            MemoryClass       `json:"class"`
	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.

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 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"`
	Class            MemoryClass       `json:"class"`
	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.

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"`
	Organization *CreateMemorySubscriptionCreateMemorySubscriptionOrganization `json:"organization"`
}

CreateMemorySubscriptionCreateMemorySubscription includes the requested fields of the GraphQL type MemorySubscription.

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.

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"`
	NodeType   string   `json:"nodeType"`
	Tags       []string `json:"tags"`
	Seq        *int     `json:"seq"`
	IsRunnable *bool    `json:"isRunnable"`
	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) 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"`
	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) 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 CreateObjectResponse added in v0.8.0 

type CreateObjectResponse struct {
	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.

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 CreateSecretCreateSecret added in v0.8.0 

type CreateSecretCreateSecret struct {
	SecretFields `json:"-"`
}

CreateSecretCreateSecret includes the requested fields of the GraphQL type Secret.

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 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.
	//
	// Error codes (extensions.code): TEAM_CHAT_BODY_TOO_LARGE,
	// TEAM_CHAT_REPLY_NOT_FOUND, SESSION_NOT_FOUND, SESSION_NOT_IN_APP (the
	// session belongs to a different App — a worker never authors across
	// Apps), SESSION_ENDED, SESSION_NOT_WORKER_BOUND,
	// SESSION_WORKER_NOT_IN_APP (the worker-App pin), 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.
	//
	// 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 persona prompt template is NOT here — with the Worker model (#974) it lives on the role-agent as dressing (personaRole + personaPrompt); 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.

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.

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.

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 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 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 {
	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 {
	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 DeleteObjectResponse added in v0.8.0 

type DeleteObjectResponse struct {
	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 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.

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, and its worker taken, until endSession or the #930 reaper. 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) 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 — the #930
	// reaper ends one too, without a client. 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.
	//
	// 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"`
	Class            MemoryClass       `json:"class"`
	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.

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).
	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"`
	NodeType   string   `json:"nodeType"`
	Tags       []string `json:"tags"`
	Seq        *int     `json:"seq"`
	IsRunnable *bool    `json:"isRunnable"`
	UpdatedAt  string   `json:"updatedAt"`
}

FindNodesFindNodesFindNodesResultHitsNodeHitNode includes the requested fields of the GraphQL type Node.

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) 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,
) (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.

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) GetPersonaPrompt added in v0.9.0 

func (v *GetAgentAgent) GetPersonaPrompt() *string

GetPersonaPrompt returns GetAgentAgent.PersonaPrompt, 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.

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"`
	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.

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 GetInvitationInvitationUserInvitation added in v0.7.0 

type GetInvitationInvitationUserInvitation struct {
	InvitationFields `json:"-"`
}

GetInvitationInvitationUserInvitation includes the requested fields of the GraphQL type UserInvitation.

func (*GetInvitationInvitationUserInvitation) GetAcceptedAt added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetAcceptedAt() *string

GetAcceptedAt returns GetInvitationInvitationUserInvitation.AcceptedAt, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationUserInvitation) GetActivationCount added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetActivationCount() int

GetActivationCount returns GetInvitationInvitationUserInvitation.ActivationCount, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationUserInvitation) GetCreatedAt added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetCreatedAt() string

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

func (*GetInvitationInvitationUserInvitation) GetEmail added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetEmail() *string

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

func (*GetInvitationInvitationUserInvitation) GetExpiresAt added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetExpiresAt() *string

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

func (*GetInvitationInvitationUserInvitation) GetGithubUsername added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetGithubUsername() *string

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

func (*GetInvitationInvitationUserInvitation) GetId added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetId() string

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

func (*GetInvitationInvitationUserInvitation) GetMaxActivations added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetMaxActivations() *int

GetMaxActivations returns GetInvitationInvitationUserInvitation.MaxActivations, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationUserInvitation) GetMemberRole added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetMemberRole() Role

GetMemberRole returns GetInvitationInvitationUserInvitation.MemberRole, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationUserInvitation) GetName added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetName() *string

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

func (*GetInvitationInvitationUserInvitation) GetOrganizationId added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetOrganizationId() *string

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

func (*GetInvitationInvitationUserInvitation) GetSlug added in v0.7.0 

func (v *GetInvitationInvitationUserInvitation) GetSlug() string

GetSlug returns GetInvitationInvitationUserInvitation.Slug, and is useful for accessing the field via an interface.

func (*GetInvitationInvitationUserInvitation) MarshalJSON added in v0.7.0 

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

func (*GetInvitationInvitationUserInvitation) UnmarshalJSON added in v0.7.0 

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

type GetInvitationResponse added in v0.7.0 

type GetInvitationResponse struct {
	Invitation *GetInvitationInvitationUserInvitation `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)

func (*GetInvitationResponse) GetInvitation added in v0.7.0 

func (v *GetInvitationResponse) GetInvitation() *GetInvitationInvitationUserInvitation

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"`
	Class              MemoryClass       `json:"class"`
	Visibility         *MemoryVisibility `json:"visibility"`
	OrganizationId     *string           `json:"organizationId"`
	IsEncrypted        bool              `json:"isEncrypted"`
	Tags               []string          `json:"tags"`
	Source             *string           `json:"source"`
	SyncStatus         SyncStatus        `json:"syncStatus"`
	VectorIndexEnabled bool              `json:"vectorIndexEnabled"`
	// #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.

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).
	//
	// '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; when the two values differ AND abstractOriginHash is non-null, the abstract may not reflect current content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string `json:"abstractOriginHash"`
	NodeType           string  `json:"nodeType"`
	// #725 — collection discriminator (which domain object this node is, e.g. "competitor"). NULL for an ordinary node.
	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"`
	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) 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"`
	Name       *string `json:"name"`
	Loc        string  `json:"loc"`
	IsRunnable *bool   `json:"isRunnable"`
	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"`
	Name       *string `json:"name"`
	Loc        string  `json:"loc"`
	IsRunnable *bool   `json:"isRunnable"`
	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 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.

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 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, and its worker taken, until endSession or the #930 reaper. 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) 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) 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 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) 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) 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"`
	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"`
	Agent     *InstallAgentIntoAppInstallAgentIntoAppInstallAgentIntoAppPayloadAppAgentAgent `json:"agent"`
	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.

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.

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 appId and agentId. 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.

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"`
	Class            MemoryClass       `json:"class"`
	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.

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 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.

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.

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.

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.

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.

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"`
	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 {
	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"`
	Class            MemoryClass       `json:"class"`
	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.

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"`
	Class            MemoryClass       `json:"class"`
	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.

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,
) (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 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"`
	// 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 personal/private) 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) 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.

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).
	//
	// '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.

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).
	//
	// '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.

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"`
	Organization *MemorySubscriptionsMemorySubscriptionsMemorySubscriptionOrganization `json:"organization"`
}

MemorySubscriptionsMemorySubscriptionsMemorySubscription includes the requested fields of the GraphQL type MemorySubscription.

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.

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).
	//
	// '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 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"`
	NodeType   string   `json:"nodeType"`
	Tags       []string `json:"tags"`
	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) 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 {
	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) 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 {
	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 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"`
	NodeType   string   `json:"nodeType"`
	Tags       []string `json:"tags"`
	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) 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 {
	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.

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 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"`
	NodeType  string  `json:"nodeType"`
	// #725 — collection discriminator (which domain object this node is, e.g. "competitor"). NULL for an ordinary node.
	ObjectType  *string `json:"objectType"`
	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; when the two values differ AND abstractOriginHash is non-null, the abstract may not reflect current content. System-managed; never settable via NodeInput.
	AbstractOriginHash *string                                                        `json:"abstractOriginHash"`
	Tags               []string                                                       `json:"tags"`
	Seq                *int                                                           `json:"seq"`
	Data               *json.RawMessage                                               `json:"data"`
	Properties         *json.RawMessage                                               `json:"properties"`
	Content            *string                                                        `json:"content"`
	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) 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"`
	Name       *string `json:"name"`
	Loc        string  `json:"loc"`
	Priority   int     `json:"priority"`
	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"`
	Name        *string          `json:"name"`
	Loc         string           `json:"loc"`
	Description *string          `json:"description"`
	IsRunnable  *bool            `json:"isRunnable"`
	Priority    int              `json:"priority"`
	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 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"`
}

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
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.

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 {
	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 {
	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"`
	NodeType  *string  `json:"nodeType,omitempty"`
	// #725 — collection facet: only nodes whose objectType equals this (e.g. "competitor").
	ObjectType    *string  `json:"objectType,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) 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) 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) 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 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 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 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 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.

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.

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.

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) 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.

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
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.

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) GetPersonaPrompt added in v0.9.0 

func (v *PublicAgentsPublicAgentsAgentsPageItemsAgent) GetPersonaPrompt() *string

GetPersonaPrompt returns PublicAgentsPublicAgentsAgentsPageItemsAgent.PersonaPrompt, 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 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) 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,
) (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 ReleaseWorkerReleaseWorker added in v0.10.0 

type ReleaseWorkerReleaseWorker struct {
	WorkerFields `json:"-"`
}

ReleaseWorkerReleaseWorker 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 (*ReleaseWorkerReleaseWorker) GetAgentId added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetAgentId() string

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

func (*ReleaseWorkerReleaseWorker) GetAppId added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetAppId() string

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

func (*ReleaseWorkerReleaseWorker) GetCreatedAt added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetCreatedAt() string

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

func (*ReleaseWorkerReleaseWorker) GetCreatedBy added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetCreatedBy() *string

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

func (*ReleaseWorkerReleaseWorker) GetHeldAt added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetHeldAt() *string

GetHeldAt returns ReleaseWorkerReleaseWorker.HeldAt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetHeldByUserId added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetHeldByUserId() *string

GetHeldByUserId returns ReleaseWorkerReleaseWorker.HeldByUserId, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetId added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetId() string

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

func (*ReleaseWorkerReleaseWorker) GetMemoryId added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetMemoryId() *string

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

func (*ReleaseWorkerReleaseWorker) GetName added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetName() string

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

func (*ReleaseWorkerReleaseWorker) GetPortalUrl added in v0.12.0 

func (v *ReleaseWorkerReleaseWorker) GetPortalUrl() *string

GetPortalUrl returns ReleaseWorkerReleaseWorker.PortalUrl, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetPrompt added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetPrompt() *string

GetPrompt returns ReleaseWorkerReleaseWorker.Prompt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetPromptOverride added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetPromptOverride() *string

GetPromptOverride returns ReleaseWorkerReleaseWorker.PromptOverride, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetRepos added in v0.12.0 

func (v *ReleaseWorkerReleaseWorker) GetRepos() []string

GetRepos returns ReleaseWorkerReleaseWorker.Repos, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetRetiredAt added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetRetiredAt() *string

GetRetiredAt returns ReleaseWorkerReleaseWorker.RetiredAt, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetRetiredBy added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetRetiredBy() *string

GetRetiredBy returns ReleaseWorkerReleaseWorker.RetiredBy, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetRole added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetRole() *string

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

func (*ReleaseWorkerReleaseWorker) GetSlug added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetSlug() string

GetSlug returns ReleaseWorkerReleaseWorker.Slug, and is useful for accessing the field via an interface.

func (*ReleaseWorkerReleaseWorker) GetUrn added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) GetUrn() *string

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

func (*ReleaseWorkerReleaseWorker) MarshalJSON added in v0.10.0 

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

func (*ReleaseWorkerReleaseWorker) UnmarshalJSON added in v0.10.0 

func (v *ReleaseWorkerReleaseWorker) 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.
	ReleaseWorker *ReleaseWorkerReleaseWorker `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,
) (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 cannot be distinguished 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.

func (*ReleaseWorkerResponse) GetReleaseWorker added in v0.10.0 

func (v *ReleaseWorkerResponse) GetReleaseWorker() *ReleaseWorkerReleaseWorker

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 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; v1 known: 'anthropic' | 'openai' | 'glm' | 'bedrock'.
	Provider string `json:"provider"`
	// Model identifier, passed verbatim to the provider.
	Model     string `json:"model"`
	HasApiKey bool   `json:"hasApiKey"`
	// Ellipsis + last 4 characters of the stored key; null when no key.
	ApiKeyPreview *string `json:"apiKeyPreview"`
	// Provider-specific knobs (maxTokens, thinking, effort, baseUrl, ...).
	Params *json.RawMessage `json:"params"`
	// Disabled configs are skipped by resolution (the walk continues outward).
	Enabled   bool    `json:"enabled"`
	CreatedAt string  `json:"createdAt"`
	UpdatedAt *string `json:"updatedAt"`
}

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 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 {
	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"`
	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) 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) 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.

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 {
	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 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).
	Degraded *string                                           `json:"degraded"`
	Reason   *string                                           `json:"reason"`
	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) 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"`
	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"`
}

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) 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) 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 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,
) (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 {
	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 {
	// Nodes the selection resolved to (after auth + prefix filtering).
	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 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) 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.

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.

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.

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 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 {
	Version string `json:"version"`
	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"`
	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 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 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.

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.

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.

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 and its worker taken until
	// endSession or the #930 reaper. 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, and its worker taken, until endSession or the #930 reaper. 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) 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"`
	EndedAt *string `json:"endedAt"`
}

StopImpersonationStopImpersonationImpersonationSession includes the requested fields of the GraphQL type ImpersonationSession.

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.

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 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). 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).
	//
	// 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,
) (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 {
	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 TeamMemoryAppMemory added in v0.9.0 

type TeamMemoryAppMemory struct {
	Id    string  `json:"id"`
	AppId *string `json:"appId"`
}

TeamMemoryAppMemory includes the requested fields of the GraphQL type Memory.

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).
	//
	// '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 personaPrompt 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.

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 persona prompt template is NOT here — with the Worker model (#974) it lives on the role-agent as dressing (personaRole + personaPrompt); 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"`
	// #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, and its worker taken, until endSession or the #930 reaper. 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) 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, and its worker taken, until endSession or the #930 reaper. 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) 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"`
}

── 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) 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 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; with another tool it matches the stored verbatim ref; with
	// no tool it matches either spelling. 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) 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 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.

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 UpdateAgentResponse added in v0.7.0 

type UpdateAgentResponse struct {
	// Update an Agent.
	//
	// urn renames the slug (org-owned agents only). personaRole / personaPrompt
	// are the persona dressing (cor:agt:020:01); 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,
	personaPrompt *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"`
	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) 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).

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.

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) GetPersonaPrompt added in v0.9.0 

func (v *UpdateAgentUpdateAgent) GetPersonaPrompt() *string

GetPersonaPrompt returns UpdateAgentUpdateAgent.PersonaPrompt, 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).
	//
	// 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 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"`
	Name       *string `json:"name"`
	Loc        string  `json:"loc"`
	IsRunnable *bool   `json:"isRunnable"`
	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.

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 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"`
	Organization *UpdateMemorySubscriptionUpdateMemorySubscriptionOrganization `json:"organization"`
}

UpdateMemorySubscriptionUpdateMemorySubscription includes the requested fields of the GraphQL type MemorySubscription.

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.

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"`
	Class            MemoryClass       `json:"class"`
	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.

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) 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 {
	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"`
	NodeType   string   `json:"nodeType"`
	Tags       []string `json:"tags"`
	IsRunnable *bool    `json:"isRunnable"`
	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) 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"`
	Edges       []*NodeEdgeInput `json:"edges,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"`
	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) 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) 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 {
	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 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"`
	NodeType   string   `json:"nodeType"`
	Tags       []string `json:"tags"`
	IsRunnable *bool    `json:"isRunnable"`
	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) 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 {
	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.

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) 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.

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 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 persona prompt template is NOT here — with the Worker model (#974) it lives on the role-agent as dressing (personaRole + personaPrompt); 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 the #930 inactivity reaper counts). 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, which the #930 inactivity reaper counts as liveness.

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, and its worker taken, until endSession or the #930 reaper. 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) 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) 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 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"`
	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.

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"`
	Name             *string `json:"name"`
	Email            *string `json:"email"`
	Handle           *string `json:"handle"`
	GithubUsername   *string `json:"githubUsername"`
	Roles            []Role  `json:"roles"`
	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.

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 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 personaPrompt 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"`
	// 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) 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) 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"`
	// 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) 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) 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) 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) 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) 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) 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.