@absolutejs/artifacts 0.1.2 → 0.1.4

package/dist/index.js

@@ -4,6 +4,18 @@ import { Value } from "@sinclair/typebox/value";
 
 // src/types.ts
 var ARTIFACT_STATUSES = ["draft", "published", "archived"];
+function isJsonValue(value) {
+  if (value === null || typeof value === "boolean" || typeof value === "string") {
+    return true;
+  }
+  if (typeof value === "number")
+    return Number.isFinite(value);
+  if (Array.isArray(value))
+    return value.every(isJsonValue);
+  if (typeof value !== "object")
+    return false;
+  return Object.values(value).every(isJsonValue);
+}
 var ARTIFACT_EVENT_TYPES = [
   "artifact.archived",
   "artifact.asset_attached",
@@ -35,7 +47,7 @@ var defineArtifactRegistry = (definitions) => ({
     if (!definition) {
       throw new ArtifactError("unknown_kind", `Unknown artifact kind: ${kind}`);
     }
-    if (!Value.Check(definition.content, content)) {
+    if (!Value.Check(definition.content, content) || !isJsonValue(content)) {
       const issue = [...Value.Errors(definition.content, content)][0];
       const detail = issue ? `${issue.path || "/"}: ${issue.message}` : "invalid content";
       throw new ArtifactError("invalid_content", `Invalid ${kind} artifact content (${detail})`);
@@ -711,7 +723,15 @@ var createMemoryArtifactStore = (initial = []) => {
 };
 // src/tools.ts
 import { Type as Type2 } from "@sinclair/typebox";
-var record = (input) => input && typeof input === "object" && !Array.isArray(input) ? input : {};
+var JsonValueSchema = Type2.Recursive((self) => Type2.Union([
+  Type2.String(),
+  Type2.Number(),
+  Type2.Boolean(),
+  Type2.Null(),
+  Type2.Array(self),
+  Type2.Record(Type2.String(), self)
+]));
+var record = (input) => isJsonValue(input) && input !== null && typeof input === "object" && !Array.isArray(input) ? input : {};
 var stringValue = (input, key) => typeof input[key] === "string" ? input[key] : undefined;
 var createArtifactTools = (options) => ({
   artifact_create: {
@@ -720,7 +740,7 @@ var createArtifactTools = (options) => ({
       const input = record(raw);
       const kind = stringValue(input, "kind");
       const title = stringValue(input, "title");
-      if (!kind || !title || input.content === undefined) {
+      if (!kind || !title || !isJsonValue(input.content)) {
         return "Provide kind, title, and content.";
       }
       const artifact = await options.service.create(options.ownerId, {
@@ -732,7 +752,7 @@ var createArtifactTools = (options) => ({
       return JSON.stringify(artifact);
     },
     input: Type2.Object({
-      content: Type2.Unknown(),
+      content: JsonValueSchema,
       kind: Type2.String({ minLength: 1 }),
       title: Type2.String({ minLength: 1 })
     })
@@ -834,6 +854,7 @@ var createArtifactTools = (options) => ({
 });
 export {
   standardArtifactDefinitions,
+  isJsonValue,
   defineArtifactRegistry,
   createMemoryArtifactStore,
   createMemoryArtifactAssetStore,

package/dist/manifest.js

@@ -168,6 +168,79 @@ var serializedTool = Type.Object({
   input: jsonSchemaObject,
   kind: Type.Union([Type.Literal("runtime"), Type.Literal("workspace")])
 });
+var productId = Type.String({ pattern: "^[a-z][a-z0-9_-]{0,63}$" });
+var productCopy = {
+  description: Type.String({ minLength: 1 }),
+  id: productId,
+  title: Type.String({ minLength: 1 })
+};
+var productOperation = Type.Union([
+  Type.Literal("aggregate"),
+  Type.Literal("create"),
+  Type.Literal("delete"),
+  Type.Literal("detail"),
+  Type.Literal("list"),
+  Type.Literal("update")
+]);
+var productProjection = Type.Object({
+  blocks: Type.Optional(Type.Array(Type.Object({
+    ...productCopy,
+    category: Type.String({ minLength: 1 }),
+    componentExport: Type.String({ minLength: 1 }),
+    frameworks: Type.Optional(Type.Array(Type.Union(clientFrameworks.map((framework) => Type.Literal(framework))))),
+    props: jsonSchemaObject
+  }))),
+  connections: Type.Optional(Type.Array(Type.Object({
+    ...productCopy,
+    envKeys: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    kind: Type.Union([
+      Type.Literal("none"),
+      Type.Literal("oauth"),
+      Type.Literal("secret")
+    ]),
+    setupTool: Type.Optional(Type.String({ pattern: TOOL_NAME_PATTERN.source })),
+    testTool: Type.Optional(Type.String({ pattern: TOOL_NAME_PATTERN.source }))
+  }))),
+  dataSources: Type.Optional(Type.Array(Type.Object({
+    ...productCopy,
+    operations: Type.Array(productOperation, { minItems: 1 }),
+    schema: jsonSchemaObject,
+    tools: Type.Optional(Type.Partial(Type.Object({
+      aggregate: Type.String({ pattern: TOOL_NAME_PATTERN.source }),
+      create: Type.String({ pattern: TOOL_NAME_PATTERN.source }),
+      delete: Type.String({ pattern: TOOL_NAME_PATTERN.source }),
+      detail: Type.String({ pattern: TOOL_NAME_PATTERN.source }),
+      list: Type.String({ pattern: TOOL_NAME_PATTERN.source }),
+      update: Type.String({ pattern: TOOL_NAME_PATTERN.source })
+    })))
+  }))),
+  events: Type.Optional(Type.Array(Type.Object({
+    ...productCopy,
+    schema: jsonSchemaObject,
+    source: Type.Union([
+      Type.Literal("data"),
+      Type.Literal("package"),
+      Type.Literal("ui"),
+      Type.Literal("webhook")
+    ])
+  }))),
+  healthChecks: Type.Optional(Type.Array(Type.Object({
+    ...productCopy,
+    tool: Type.String({ pattern: TOOL_NAME_PATTERN.source })
+  }))),
+  releaseChecks: Type.Optional(Type.Array(Type.Object({
+    ...productCopy,
+    healthCheckIds: Type.Optional(Type.Array(productId)),
+    severity: Type.Union([
+      Type.Literal("blocking"),
+      Type.Literal("warning")
+    ])
+  }))),
+  workflowActions: Type.Optional(Type.Array(Type.Object({
+    ...productCopy,
+    tool: Type.String({ pattern: TOOL_NAME_PATTERN.source })
+  })))
+});
 var manifestSchema = Type.Object({
   contract: Type.Union([Type.Literal(1), Type.Literal(2)]),
   discovery: Type.Optional(Type.Object({
@@ -193,6 +266,14 @@ var manifestSchema = Type.Object({
     tagline: Type.String({ minLength: 1 })
   }),
   implements: Type.Optional(Type.Array(adapterImplementation)),
+  integration: Type.Optional(Type.Object({
+    description: Type.Optional(Type.String({ minLength: 1 })),
+    mode: Type.Union([
+      Type.Literal("adapter"),
+      Type.Literal("code-first"),
+      Type.Literal("recipe")
+    ])
+  })),
   lifecycle: Type.Optional(Type.Array(lifecycleStep)),
   presets: Type.Optional(Type.Array(Type.Object({
     description: Type.Optional(Type.String()),
@@ -200,6 +281,7 @@ var manifestSchema = Type.Object({
     title: Type.String(),
     values: Type.Record(Type.String(), Type.Unknown())
   }))),
+  product: Type.Optional(productProjection),
   requires: Type.Optional(manifestRequirements),
   settings: jsonSchemaObject,
   slots: Type.Optional(Type.Record(Type.String(), adapterSlot)),
@@ -220,6 +302,48 @@ var manifest = defineManifest()({
     name: "@absolutejs/artifacts",
     tagline: "Give everything your AI makes a real lifecycle."
   },
+  product: {
+    blocks: [
+      {
+        category: "content",
+        componentExport: "ArtifactWorkspace",
+        description: "Browse a typed artifact, its lifecycle state, and immutable revision history.",
+        frameworks: ["react", "client"],
+        id: "artifact_workspace",
+        props: Type2.Object({
+          artifactId: Type2.String({ minLength: 1 }),
+          ownerId: Type2.String({ minLength: 1 })
+        }),
+        title: "Artifact workspace"
+      }
+    ],
+    dataSources: [
+      {
+        description: "Owner-scoped typed artifacts with current state and immutable revisions.",
+        id: "artifacts",
+        operations: ["list", "detail"],
+        schema: Type2.Object({
+          artifactId: Type2.String(),
+          kind: Type2.String(),
+          ownerId: Type2.String(),
+          revision: Type2.Integer()
+        }),
+        title: "Artifacts",
+        tools: {
+          detail: "artifact_get",
+          list: "artifact_list"
+        }
+      }
+    ],
+    workflowActions: [
+      {
+        description: "Restore an immutable artifact revision as a new private draft.",
+        id: "restore_artifact",
+        title: "Restore artifact revision",
+        tool: "artifact_restore"
+      }
+    ]
+  },
   implements: [
     defineImplementation()({
       contract: "artifacts/store",

package/dist/manifest.json

@@ -8,6 +8,84 @@
 		"name": "@absolutejs/artifacts",
 		"tagline": "Give everything your AI makes a real lifecycle."
 	},
+	"product": {
+		"blocks": [
+			{
+				"category": "content",
+				"componentExport": "ArtifactWorkspace",
+				"description": "Browse a typed artifact, its lifecycle state, and immutable revision history.",
+				"frameworks": [
+					"react",
+					"client"
+				],
+				"id": "artifact_workspace",
+				"props": {
+					"type": "object",
+					"required": [
+						"artifactId",
+						"ownerId"
+					],
+					"properties": {
+						"artifactId": {
+							"minLength": 1,
+							"type": "string"
+						},
+						"ownerId": {
+							"minLength": 1,
+							"type": "string"
+						}
+					}
+				},
+				"title": "Artifact workspace"
+			}
+		],
+		"dataSources": [
+			{
+				"description": "Owner-scoped typed artifacts with current state and immutable revisions.",
+				"id": "artifacts",
+				"operations": [
+					"list",
+					"detail"
+				],
+				"schema": {
+					"type": "object",
+					"required": [
+						"artifactId",
+						"kind",
+						"ownerId",
+						"revision"
+					],
+					"properties": {
+						"artifactId": {
+							"type": "string"
+						},
+						"kind": {
+							"type": "string"
+						},
+						"ownerId": {
+							"type": "string"
+						},
+						"revision": {
+							"type": "integer"
+						}
+					}
+				},
+				"title": "Artifacts",
+				"tools": {
+					"detail": "artifact_get",
+					"list": "artifact_list"
+				}
+			}
+		],
+		"workflowActions": [
+			{
+				"description": "Restore an immutable artifact revision as a new private draft.",
+				"id": "restore_artifact",
+				"title": "Restore artifact revision",
+				"tool": "artifact_restore"
+			}
+		]
+	},
 	"implements": [
 		{
 			"contract": "artifacts/store",

package/dist/src/drizzle.d.ts

@@ -138,13 +138,13 @@ export declare const artifactRevisions: import("drizzle-orm/pg-core").PgTableWit
         }>;
         document: import("drizzle-orm/pg-core").PgBuildColumn<"artifact_revisions", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
             dataType: "custom";
-            data: Readonly<ArtifactRecord<unknown>>;
+            data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
             driverParam: unknown;
         }>>, {
             name: string;
             tableName: "artifact_revisions";
             dataType: "custom";
-            data: Readonly<ArtifactRecord<unknown>>;
+            data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
             driverParam: unknown;
             notNull: true;
             hasDefault: false;
@@ -760,13 +760,13 @@ export declare const artifactDrizzleSchema: {
             }>;
             document: import("drizzle-orm/pg-core").PgBuildColumn<"artifact_revisions", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
                 dataType: "custom";
-                data: Readonly<ArtifactRecord<unknown>>;
+                data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
                 driverParam: unknown;
             }>>, {
                 name: string;
                 tableName: "artifact_revisions";
                 dataType: "custom";
-                data: Readonly<ArtifactRecord<unknown>>;
+                data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
                 driverParam: unknown;
                 notNull: true;
                 hasDefault: false;
@@ -1051,13 +1051,13 @@ export declare const ArtifactRevisionInsertSchema: import("drizzle-typebox").Bui
     }>;
     document: import("drizzle-orm/pg-core").PgBuildColumn<"artifact_revisions", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
         dataType: "custom";
-        data: Readonly<ArtifactRecord<unknown>>;
+        data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
         driverParam: unknown;
     }>>, {
         name: string;
         tableName: "artifact_revisions";
         dataType: "custom";
-        data: Readonly<ArtifactRecord<unknown>>;
+        data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
         driverParam: unknown;
         notNull: true;
         hasDefault: false;
@@ -1117,13 +1117,13 @@ export declare const ArtifactRevisionSelectSchema: import("drizzle-typebox").Bui
     }>;
     document: import("drizzle-orm/pg-core").PgBuildColumn<"artifact_revisions", import("drizzle-orm/pg-core").SetNotNull<import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
         dataType: "custom";
-        data: Readonly<ArtifactRecord<unknown>>;
+        data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
         driverParam: unknown;
     }>>, {
         name: string;
         tableName: "artifact_revisions";
         dataType: "custom";
-        data: Readonly<ArtifactRecord<unknown>>;
+        data: Readonly<ArtifactRecord<import("./types").JsonValue>>;
         driverParam: unknown;
         notNull: true;
         hasDefault: false;

package/dist/src/generators.d.ts

@@ -1,7 +1,7 @@
-import type { ArtifactAssetWriteInput, ArtifactBundleCreateInput, ArtifactProvenance, ArtifactRecord } from "./types";
+import type { ArtifactAssetWriteInput, ArtifactBundleCreateInput, ArtifactProvenance, ArtifactRecord, JsonObject, JsonValue } from "./types";
 export type ArtifactGenerationInput = {
     createdBy: string;
-    input?: Record<string, unknown>;
+    input?: JsonObject;
     kind: string;
     ownerId: string;
     prompt?: string;
@@ -12,8 +12,8 @@ export type ArtifactGenerationContext = {
 };
 export type ArtifactGenerationResult = {
     assets?: ArtifactAssetWriteInput[];
-    content: unknown;
-    metadata?: Record<string, unknown>;
+    content: JsonValue;
+    metadata?: JsonObject;
     provenance?: ArtifactProvenance;
     title?: string;
     warnings?: string[];

package/dist/src/index.d.ts

@@ -13,4 +13,4 @@ export { createArtifactRendererRegistry, type ArtifactRenderer, type ArtifactRen
 export { createArtifactService, type ArtifactPublisher, type ArtifactService, type ArtifactServiceOptions, } from "./service";
 export { createMemoryArtifactStore, createMemoryArtifactAssetStore, type ArtifactAssetStore, type ArtifactAssetTransaction, type ArtifactStore, } from "./store";
 export { createArtifactTools, type ArtifactToolDefinition, type ArtifactToolMap, type ArtifactToolOptions, } from "./tools";
-export { ARTIFACT_STATUSES, ARTIFACT_EVENT_TYPES, ArtifactError, type ArtifactAssetReference, type ArtifactAssetRole, type ArtifactAssetWriteInput, type ArtifactBundleCreateInput, type ArtifactCapability, type ArtifactCreateInput, type ArtifactErrorCode, type ArtifactEvent, type ArtifactEventQuery, type ArtifactEventType, type ArtifactGarbageCollectionResult, type ArtifactIndexingState, type ArtifactIndexingStatus, type ArtifactListQuery, type ArtifactLineageReference, type ArtifactLineageRelation, type ArtifactProvenance, type ArtifactPublication, type ArtifactPublishInput, type ArtifactRecord, type ArtifactRevision, type ArtifactRetentionCandidate, type ArtifactStatus, type ArtifactUpdateInput, } from "./types";
+export { ARTIFACT_STATUSES, ARTIFACT_EVENT_TYPES, ArtifactError, isJsonValue, type ArtifactAssetReference, type ArtifactAssetRole, type ArtifactAssetWriteInput, type ArtifactBundleCreateInput, type ArtifactCapability, type ArtifactCreateInput, type ArtifactErrorCode, type ArtifactEvent, type ArtifactEventQuery, type ArtifactEventType, type ArtifactGarbageCollectionResult, type ArtifactIndexingState, type ArtifactIndexingStatus, type ArtifactListQuery, type ArtifactLineageReference, type ArtifactLineageRelation, type ArtifactProvenance, type ArtifactPublication, type ArtifactPublishInput, type ArtifactRecord, type ArtifactRevision, type ArtifactRetentionCandidate, type ArtifactStatus, type ArtifactUpdateInput, type JsonObject, type JsonPrimitive, type JsonValue, } from "./types";

package/dist/src/manifest.d.ts

@@ -11,10 +11,10 @@ export declare const manifest: Omit<import("@absolutejs/manifest").PackageManife
     detach: (ownerId: string, artifactId: string, assetId: string, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
     get: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
     getIndexingState: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactIndexingState | null>;
-    getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>>;
+    getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<import("./types").JsonValue>>>;
     list: (ownerId: string, query?: import("./types").ArtifactListQuery) => Promise<import("./types").ArtifactRecord[]>;
     listEvents: (query?: import("./types").ArtifactEventQuery) => Promise<import("./types").ArtifactEvent[]>;
-    listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>[]>;
+    listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<import("./types").JsonValue>>[]>;
     markEventProcessed: (eventId: string, processedAt?: string) => Promise<boolean>;
     markIndexing: (ownerId: string, artifactId: string, input: {
         documentIds?: string[];
@@ -46,10 +46,10 @@ export declare const manifest: Omit<import("@absolutejs/manifest").PackageManife
         detach: (ownerId: string, artifactId: string, assetId: string, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
         get: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
         getIndexingState: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactIndexingState | null>;
-        getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>>;
+        getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<import("./types").JsonValue>>>;
         list: (ownerId: string, query?: import("./types").ArtifactListQuery) => Promise<import("./types").ArtifactRecord[]>;
         listEvents: (query?: import("./types").ArtifactEventQuery) => Promise<import("./types").ArtifactEvent[]>;
-        listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>[]>;
+        listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<import("./types").JsonValue>>[]>;
         markEventProcessed: (eventId: string, processedAt?: string) => Promise<boolean>;
         markIndexing: (ownerId: string, artifactId: string, input: {
             documentIds?: string[];
@@ -82,10 +82,10 @@ export declare const manifest: Omit<import("@absolutejs/manifest").PackageManife
         detach: (ownerId: string, artifactId: string, assetId: string, expectedRevision?: number) => Promise<import("./types").ArtifactRecord>;
         get: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactRecord>;
         getIndexingState: (ownerId: string, artifactId: string) => Promise<import("./types").ArtifactIndexingState | null>;
-        getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>>;
+        getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<import("./types").ArtifactRecord<import("./types").JsonValue>>>;
         list: (ownerId: string, query?: import("./types").ArtifactListQuery) => Promise<import("./types").ArtifactRecord[]>;
         listEvents: (query?: import("./types").ArtifactEventQuery) => Promise<import("./types").ArtifactEvent[]>;
-        listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<unknown>>[]>;
+        listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<import("./types").ArtifactRecord<import("./types").JsonValue>>[]>;
         markEventProcessed: (eventId: string, processedAt?: string) => Promise<boolean>;
         markIndexing: (ownerId: string, artifactId: string, input: {
             documentIds?: string[];

package/dist/src/registry.d.ts

@@ -1,5 +1,5 @@
 import type { Static, TSchema } from "@sinclair/typebox";
-import { type ArtifactCapability } from "./types";
+import { type ArtifactCapability, type JsonValue } from "./types";
 export type ArtifactAssetPolicy = {
     /** Exact media types or wildcards such as image/* and application/*. */
     acceptedMediaTypes?: string[];
@@ -18,6 +18,6 @@ export type ArtifactContent<TDefinitions extends ArtifactKindDefinitions, TKind
 export type ArtifactRegistry<TDefinitions extends ArtifactKindDefinitions> = {
     definitions: TDefinitions;
     kindNames: Array<keyof TDefinitions & string>;
-    parse<TKind extends keyof TDefinitions & string>(kind: TKind, content: unknown): ArtifactContent<TDefinitions, TKind>;
+    parse<TKind extends keyof TDefinitions & string>(kind: TKind, content: unknown): ArtifactContent<TDefinitions, TKind> & JsonValue;
 };
 export declare const defineArtifactRegistry: <const TDefinitions extends ArtifactKindDefinitions>(definitions: TDefinitions) => ArtifactRegistry<TDefinitions>;

package/dist/src/service.d.ts

@@ -37,10 +37,10 @@ export declare const createArtifactService: <TDefinitions extends ArtifactKindDe
     detach: (ownerId: string, artifactId: string, assetId: string, expectedRevision?: number) => Promise<ArtifactRecord>;
     get: (ownerId: string, artifactId: string) => Promise<ArtifactRecord>;
     getIndexingState: (ownerId: string, artifactId: string) => Promise<ArtifactIndexingState | null>;
-    getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<ArtifactRecord<unknown>>>;
+    getRevision: (ownerId: string, artifactId: string, revision: number) => Promise<Readonly<ArtifactRecord<import("./types").JsonValue>>>;
     list: (ownerId: string, query?: ArtifactListQuery) => Promise<ArtifactRecord[]>;
     listEvents: (query?: ArtifactEventQuery) => Promise<ArtifactEvent[]>;
-    listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<ArtifactRecord<unknown>>[]>;
+    listRevisions: (ownerId: string, artifactId: string) => Promise<Readonly<ArtifactRecord<import("./types").JsonValue>>[]>;
     markEventProcessed: (eventId: string, processedAt?: string) => Promise<boolean>;
     markIndexing: (ownerId: string, artifactId: string, input: {
         documentIds?: string[];

package/dist/src/types.d.ts

@@ -1,4 +1,10 @@
 export declare const ARTIFACT_STATUSES: readonly ["draft", "published", "archived"];
+export type JsonPrimitive = boolean | null | number | string;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export declare function isJsonValue(value: unknown): value is JsonValue;
 export type ArtifactStatus = (typeof ARTIFACT_STATUSES)[number];
 export type ArtifactCapability = "attach" | "archive" | "edit" | "export" | "preview" | "publish" | "refine";
 export type ArtifactProvenance = {
@@ -31,7 +37,7 @@ export type ArtifactAssetReference = {
     id: string;
     createdAt: string;
     mediaType: string;
-    metadata?: Record<string, unknown>;
+    metadata?: JsonObject;
     name: string;
     role: ArtifactAssetRole;
     size: number;
@@ -41,11 +47,11 @@ export type ArtifactAssetReference = {
 export type ArtifactAssetWriteInput = {
     data: Uint8Array;
     mediaType: string;
-    metadata?: Record<string, unknown>;
+    metadata?: JsonObject;
     name: string;
     role?: ArtifactAssetRole;
 };
-export type ArtifactRecord<TContent = unknown> = {
+export type ArtifactRecord<TContent = JsonValue> = {
     assets: ArtifactAssetReference[];
     capabilities: ArtifactCapability[];
     content: TContent;
@@ -53,7 +59,7 @@ export type ArtifactRecord<TContent = unknown> = {
     createdBy: string;
     id: string;
     kind: string;
-    metadata: Record<string, unknown>;
+    metadata: JsonObject;
     ownerId: string;
     provenance?: ArtifactProvenance;
     publication?: ArtifactPublication;
@@ -70,7 +76,7 @@ export type ArtifactEvent = {
     createdAt: string;
     id: string;
     ownerId: string;
-    payload?: Record<string, unknown>;
+    payload?: JsonObject;
     processedAt?: string;
     revision: number;
     type: ArtifactEventType;
@@ -91,7 +97,7 @@ export type ArtifactIndexingState = {
     updatedAt: string;
 };
 /** An immutable point-in-time copy of an artifact record. */
-export type ArtifactRevision<TContent = unknown> = Readonly<ArtifactRecord<TContent>>;
+export type ArtifactRevision<TContent = JsonValue> = Readonly<ArtifactRecord<TContent>>;
 export type ArtifactListQuery = {
     kind?: string;
     limit?: number;
@@ -99,18 +105,18 @@ export type ArtifactListQuery = {
 };
 export type ArtifactCreateInput = {
     assets?: ArtifactAssetReference[];
-    content: unknown;
+    content: JsonValue;
     createdBy: string;
     kind: string;
-    metadata?: Record<string, unknown>;
+    metadata?: JsonObject;
     provenance?: ArtifactProvenance;
     title: string;
 };
 export type ArtifactUpdateInput = {
     assets?: ArtifactAssetReference[];
-    content?: unknown;
+    content?: JsonValue;
     expectedRevision?: number;
-    metadata?: Record<string, unknown>;
+    metadata?: JsonObject;
     title?: string;
 };
 export type ArtifactBundleCreateInput = Omit<ArtifactCreateInput, "assets"> & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@absolutejs/artifacts",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Typed, versioned artifacts for AI products — schemas, lifecycle, storage, rendering, publishing, revisions, and agent tools without prescribing a database or host.",
   "author": "Alex Kahn",
   "license": "BUSL-1.1",
@@ -83,7 +83,7 @@
     }
   },
   "dependencies": {
-    "@absolutejs/manifest": "^0.7.2",
+    "@absolutejs/manifest": "^0.8.0",
     "@sinclair/typebox": "^0.34.0",
     "drizzle-typebox": "1.0.0-beta.14-a36c63d"
   },