artifact.create
A file, document, code, image or table the harness produced, with a version.
Direction: Harness → Chips
Sent by: a harness
Requires a run: no
Schema: artifact.create.json
Fields
Section titled “Fields”Every event also carries the envelope.
| Field | Required | Type | Description |
|---|---|---|---|
v |
yes | 1 |
Protocol major version. |
type |
yes | "artifact.create" |
|
id |
yes | string |
The event’s own id. Stable across a retry of the same event. |
ts |
yes | string |
When it happened, by Chips’ clock. Stamped on the way in; a value the sender writes is replaced. |
workspace_id |
yes | string |
A workspace identifier: ws_ followed by a ULID. |
space_id |
no | string |
The space, when the event belongs to one. |
run_id |
no | string |
The run, when the event belongs to one. |
seq |
no | number |
Assigned by the server on append, monotonic per workspace. Absent on the way in. |
idempotency_key |
no | string |
Required on every client-originated write. Sending the same key twice is a no-op. |
actor |
yes | object | The participant an event is attributed to. |
actor.kind |
yes | "person" | "harness" | "agent" | "system" |
Whether a person, a harness, one of a harness’s agents or Chips itself acted. |
actor.id |
yes | string |
The participant id, or system for Chips. |
actor.harness_id |
no | string |
For an agent: the harness it speaks through, whose budget and runs are the agent’s (ADR 0087). Filled in by Chips. |
artifact_id |
yes | string |
Content-addressed, like every attachment. |
kind |
yes | "file" | "document" | "code" | "image" | "table" |
How to render it. |
title |
yes | string |
What to call it. |
version |
no | number |
Bumped when the harness revises it. |
attachment |
no | object | The bytes, when the artifact is a file. |
attachment.attachment_id |
yes | string |
A attachment identifier: att_ followed by a ULID. |
attachment.filename |
yes | string |
The name to show. Never trusted for its type. |
attachment.mime_type |
yes | string |
Sniffed from the bytes on upload, not taken from the client. |
attachment.byte_size |
yes | number |
Size in bytes. |
attachment.sha256 |
yes | string |
Lowercase hex digest. The store is content-addressed. |
attachment.width |
no | number |
Pixels, for images and video. |
attachment.height |
no | number |
Pixels, for images and video. |
attachment.duration_ms |
no | number |
Milliseconds, for audio and video. |
attachment.transcript |
no | string |
What was said, for a voice note the server transcribed when it arrived (ADR 0054). Machine-heard: the person’s words as best the server could make them out. |
attachment.replaces |
no | string |
The version of the room’s file of this name that this one was made from (ADR 0099), from the post’s replaces. Filled in by Chips; a value the sender writes is replaced. |
body |
no | string |
The content, when the artifact is text. |
language |
no | string |
For code, the language to highlight. |
Example
Section titled “Example”{ "v": 1, "type": "artifact.create", "id": "evt_01K4ZQPX00000000000000006A", "ts": "2026-09-02T14:22:06.004Z", "workspace_id": "ws_01K4ZQPX000000000000000001", "space_id": "spc_01K4ZQPX000000000000000002", "actor": { "kind": "harness", "id": "hrn_01K4ZQPX000000000000000004" }, "run_id": "run_01K4ZQPX000000000000000005", "artifact_id": "att_01K4ZQPX00000000000000000C", "kind": "document", "title": "Northwind confirmation, PO #4471", "version": 1, "body": "Hi Dana, confirming PO #4471 for 120 units, delivery 19 September."}