diff --git a/surfsense_web/features/chat-artifacts/model/artifact.ts b/surfsense_web/features/chat-artifacts/model/artifact.ts
new file mode 100644
index 000000000..e63f84a85
--- /dev/null
+++ b/surfsense_web/features/chat-artifacts/model/artifact.ts
@@ -0,0 +1,23 @@
+/** Deliverable kinds the agent can produce and surface in the artifacts sidebar. */
+export type ArtifactKind = "report" | "resume" | "podcast" | "video" | "image";
+
+export type ArtifactStatus = "running" | "ready" | "error";
+
+/**
+ * A chat deliverable, aggregated from the assistant message stream. One entry
+ * per deliverable tool call; the heavy content stays in the inline card and is
+ * fetched lazily by the panel/card on demand.
+ */
+export interface ChatArtifact {
+	/** Stable identity for list keys + dedupe — entity id when known, else the tool call id. */
+	key: string;
+	kind: ArtifactKind;
+	title: string;
+	status: ArtifactStatus;
+	/** Anchors the scroll-to-card jump back into the conversation. */
+	toolCallId: string;
+	/** Backing entity id for report/resume/podcast/video; null for images. */
+	entityId: number | null;
+	/** Report panel content type — "typst" for resumes, "markdown" otherwise. */
+	contentType: "markdown" | "typst";
+}