Artifacts Client

artifacts = await client.artifacts.list()
for artifact in artifacts:
    print(f"{artifact.title}  -  {artifact.status} ({artifact.domain})")

artifact = await client.artifacts.get(artifact_id="your-artifact-id")
print(f"{artifact.title}: quality={artifact.quality_score}")

artifact = await client.artifacts.create_from_agent(
    agent_id="your-agent-id"
)
print(f"Created: {artifact.title} ({artifact.id})")

from pathlib import Path

artifact = await client.artifacts.upload(
    name="E-commerce Pricing Framework",
    file_path="./pricing-playbook.pdf",
    agent_id=None,        # optional: associate with an agent
    domain="e-commerce",
)

artifact = await client.artifacts.analyze_coverage(
    artifact_id="your-artifact-id"
)
# Coverage results are stored on the artifact

artifact = await client.artifacts.publish(
    artifact_id="your-artifact-id"
)
print(f"Status: {artifact.status}")  # "pending_review"

analytics = await client.artifacts.analytics(
    artifact_id="your-artifact-id"
)
print(f"Subscribers: {analytics.subscriber_count}")
print(f"Total queries: {analytics.total_queries}")
print(f"Tokens earned: {analytics.tokens_earned}")

@dataclass
class Artifact:
    id: str
    title: str
    domain: str
    status: str              # draft, pending_review, listed, suspended
    description: str
    hosting_type: str | None # kate_hosted
    creation_type: str | None # kh_agent, kh_upload
    visibility: str | None   # private, team, listed, paid
    price_tokens: int        # Subscription cost
    per_query_tokens: int    # Per-query cost
    version: str             # Semantic version
    quality_score: float | None
    covers_generated: bool
    user_id: str | None
    agent_id: str | None
    created_at: str | None
    updated_at: str | None

@dataclass
class ArtifactAnalytics:
    subscriber_count: int
    total_queries: int
    tokens_earned: int