import type { LinkKind } from './ids.ts'

// What `meta` says on board shapes (group README, Shared contracts). Agents write AgentMeta through
// the canvas MCP; the browser writes PersonMeta and the human-touched flags.

export interface AgentMeta {
	createdBy: 'agent'
	/** The member the agent works for. */
	onBehalfOf: string
	runId: string | null
	paperId?: string
	/** Written by an external agent through a personal token (T11). */
	via?: 'external'
}

export interface PersonMeta {
	/** Member ID, set by the browser when a person creates the shape. */
	author: string
}

export interface HumanTouched {
	/** A person moved it: agents never change its position or parent again. */
	pinnedByHuman?: boolean
	/** A person edited its props: agents never change its props again. */
	editedByHuman?: boolean
}

/** Meta on the built-in arrows that link two paper cards. */
export interface LinkMeta {
	kind: LinkKind
	/** Text a person wrote, or empty. */
	label: string
	/** "agent", "pubmed" or a member ID. */
	by: string
	hiddenByHuman: boolean
}

/** Meta on the built-in frames that hold a cluster (T02 phase 2). */
export interface ClusterMeta {
	clusterId: string
	labelGenerated: boolean
	renamedByHuman: boolean
}

type Meta = Record<string, unknown> | undefined

export const isAgentShape = (meta: Meta) => meta?.createdBy === 'agent'
export const isHumanTouched = (meta: Meta) => meta?.pinnedByHuman === true || meta?.editedByHuman === true