artifact verbs

Generic artifact administration verbs that complement the core polymorphic surface.

Verbs in this namespace: 7

---

scidex.artifact.actors

# read verb
async def scidex_artifact_actors(
    args: ArtifactActorsIn,
    ctx: Context,
) -> ArtifactActorsOut: ...

List actors who’ve engaged with the artifact, newest-first.

Input fields

Field	Type	Required
ref	`Ref	string`
kinds	`list[string]	null`
limit	integer	no

Output: ArtifactActorsOut

---

scidex.artifact.compare

# read verb
async def scidex_artifact_compare(
    args: ArtifactCompareIn,
    ctx: Context,
) -> ArtifactCompareOut: ...

Compare two artifacts on signal volume, kinds, and actor set.

Input fields

Field	Type	Required
ref_a	`Ref	string`
ref_b	`Ref	string`
top_n_common	integer	no

Output: ArtifactCompareOut

---

scidex.artifact.embedding_status

# read verb
async def scidex_artifact_embedding_status(
    args: ArtifactEmbeddingStatusIn,
    ctx: Context,
) -> ArtifactEmbeddingStatusOut: ...

Return whether a given artifact has a computed embedding. Raises not_found (HTTP 404) if the artifact does not exist.

Input fields

Field	Type	Required
artifact_type	string	yes
artifact_id	string	yes

Output: ArtifactEmbeddingStatusOut

---

scidex.artifact.provenance

# read verb
async def scidex_artifact_provenance(
    args: ArtifactProvenanceIn,
    ctx: Context,
) -> ArtifactProvenanceOut: ...

Return the lineage graph for an artifact. Raises not_found if the artifact does not exist.

Input fields

Field	Type	Required
artifact_id	string	yes
direction	string	no
max_depth	integer	no

Output: ArtifactProvenanceOut

---

scidex.artifact.related

# read verb
async def scidex_artifact_related(
    args: ArtifactRelatedIn,
    ctx: Context,
) -> ArtifactRelatedOut: ...

Return the top-N most-related artifacts to a given ref. Composite of same-type, same-domain, linked, and co-view signals.

Input fields

Field	Type	Required
ref	`Ref	string`
limit	integer	no

Output: ArtifactRelatedOut

---

scidex.artifact.view

# write verb
async def scidex_artifact_view(
    args: ArtifactViewIn,
    ctx: Context,
) -> ArtifactViewOut: ...

Record an artifact-detail-page view. Idempotent inside a 5-minute window per (actor_id, artifact_ref).

Input fields

Field	Type	Required
ref	ArtifactRef	yes
session_id	`string	null`

Output: ArtifactViewOut

---

scidex.artifact.views

# read verb
async def scidex_artifact_views(
    args: ArtifactViewsIn,
    ctx: Context,
) -> ArtifactViewsOut: ...

Return total / 7-day / 24-hour view counts for an artifact. Cached 60 seconds in-process per ref.

Input fields

Field	Type	Required
ref	ArtifactRef	yes

Output: ArtifactViewsOut

---