Struct ObjectDescriptor 

pub struct ObjectDescriptor {
    pub id: ObjectId,
    pub kind: ObjectKind,
    pub owner: TaskId,
    pub digest: String,
    pub size: u64,
    pub residency: Residency,
    pub payload_ref: Option<String>,
    pub version: u64,
    pub preview: Option<CompactString>,
}

spc_006-05: the unified Kernel-internal descriptor spc_006 §4 targets for ToolResult/Memory/Knowledge/Artifact/AgentResult (and the three IPC-facing kinds Dataset/File/WorkflowOutput ObjectKind adds room for). Additive and parallel to Handle/HandleTable — this card does not replace or migrate either.

Field type choices (spec left both open, resolved here):

• id: ObjectId reuses HandleId rather than a new id space — ObjectDescriptor is framed throughout spc_006 §4-§5 as the same addressable-object concept Handle already is, just generalized beyond in-context residency (this file’s own header already anticipates the context manager becoming “a view over” the handle table); a second parallel id space would fight that convergence instead of serving it.
• digest: String and payload_ref: Option<String> mirror Residency::External’s own field types exactly (spc_006-05’s own instruction: “复用 Residency::External 里已有的 digest 类 型”) — no Digest/PayloadRef newtype exists anywhere in this codebase to reuse, and inventing one here would be exactly the “重新发明” the card says not to do.

Fields

id: ObjectId

kind: ObjectKind

owner: TaskId

digest: String

size: u64

residency: Residency

payload_ref: Option<String>

version: u64

preview: Option<CompactString>

spc_006-06: a short excerpt a cross-task reader sees by default — never the full body. None for descriptors with no externally-stored content (e.g. small Resident objects short enough that the whole thing already fits, per Residency::occupies_context).

Implementations

impl ObjectDescriptor

pub fn from_handle(owner: TaskId, handle: &Handle, version: u64) -> Self

Project an existing handle into the unified object registry without copying its body.

pub fn external( id: ObjectId, kind: ObjectKind, owner: TaskId, version: u64, residency: Residency, preview: impl Into<CompactString>, ) -> Self

spc_006-06: build the descriptor a cross-task reader (Agent B) receives for an object whose full body lives outside working context (Agent A’s large Artifact/ToolResult/etc.). By construction — ObjectDescriptor has no payload/content field at all — a caller holding one physically cannot read the full body without a separate, explicit page-in (spc_006 §5: “Pass handles, not prompts”).

Takes an already-built Residency::External (rather than its three fields individually) so payload_ref/digest are entered once, not twice over — a caller passing the wrong Residency variant gets a clear panic rather than a descriptor silently missing its locator.

Trait Implementations

impl Clone for ObjectDescriptor

fn clone(&self) -> ObjectDescriptor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ObjectDescriptor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ObjectDescriptor

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ObjectDescriptor

impl PartialEq for ObjectDescriptor

fn eq(&self, other: &ObjectDescriptor) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ObjectDescriptor

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ObjectDescriptor