@elqora/artifacts 0.1.0

package/README.md

@@ -0,0 +1,52 @@
+# `@elqora/artifacts`
+
+TypeScript SDK for the language-neutral Elqora Artifact Protocol. It provides
+typed contracts for artifact identity, immutable versions, physical and
+provider sources, contextual links, specifications, submissions, verification,
+integrity, and declarative policies.
+
+The SDK defines protocol data. Applications remain responsible for storage,
+workflows, authorization, provider clients, and user interfaces.
+
+## Install
+
+```sh
+npm install @elqora/artifacts
+```
+
+The package is ESM-only and supports Node.js 20 or newer.
+
+## Use
+
+```ts
+import {
+  ARTIFACT_PROTOCOL_VERSION,
+  type Artifact,
+  type ArtifactSpec,
+  type ArtifactVersion,
+} from "@elqora/artifacts";
+
+const artifact: Artifact<"delivery_evidence", "image"> = {
+  schemaVersion: ARTIFACT_PROTOCOL_VERSION,
+  id: "artifact_1",
+  kind: "delivery_evidence",
+  valueType: "image",
+  createdBy: { type: "user", id: "user_1" },
+  createdAt: "2026-08-15T09:00:00Z",
+  updatedAt: "2026-08-15T09:00:00Z",
+};
+```
+
+The root export includes the ergonomic TypeScript interfaces, generated
+`Wire*` contracts, and closed-vocabulary constants. Generated contracts follow
+the canonical JSON Schemas in the
+[source repository](https://github.com/elqora/artifacts).
+
+## Compatibility
+
+During `0.x`, changes are additive by default. Existing public exports and wire
+serialization are preserved unless a documented correction is unavoidable.
+The serialized protocol `schemaVersion` is independent of the npm package
+version.
+
+Licensed under AGPL-3.0-only.

package/dist/generated/vocabulary.d.ts

@@ -0,0 +1,10 @@
+export declare const ARTIFACT_VALUE_TYPES: readonly ["text", "number", "boolean", "currency", "date", "datetime", "time", "location", "file", "image", "video", "audio", "link", "structured", "reference", "signature", "collection"];
+export declare const ARTIFACT_SOURCE_TYPES: readonly ["inline", "local", "object", "url", "hosted", "provider"];
+export declare const LOCAL_ARTIFACT_SYNC_STATES: readonly ["local_only", "pending_upload", "uploading", "uploaded", "failed"];
+export declare const ARTIFACT_INTEGRITY_ALGORITHMS: readonly ["sha256", "sha384", "sha512"];
+export declare const ARTIFACT_CONDITION_KINDS: readonly ["state", "actor", "artifact_exists", "artifact_value", "and", "or", "not"];
+export declare const ARTIFACT_VALUE_OPERATORS: readonly ["eq", "neq", "gt", "gte", "lt", "lte", "contains", "in"];
+export declare const ARTIFACT_PRIVACY_CLASSIFICATIONS: readonly ["public", "internal", "private", "sensitive", "restricted"];
+export declare const ARTIFACT_PRIVACY_REPRESENTATIONS: readonly ["hidden", "masked", "approximate", "full"];
+export declare const ARTIFACT_VERIFICATION_STATUSES: readonly ["pending", "verified", "rejected", "waived"];
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/generated/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../../src/generated/vocabulary.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oBAAoB,6LAkBvB,CAAC;AACX,eAAO,MAAM,qBAAqB,qEAOxB,CAAC;AACX,eAAO,MAAM,0BAA0B,8EAM7B,CAAC;AACX,eAAO,MAAM,6BAA6B,yCAIhC,CAAC;AACX,eAAO,MAAM,wBAAwB,sFAQ3B,CAAC;AACX,eAAO,MAAM,wBAAwB,oEAS3B,CAAC;AACX,eAAO,MAAM,gCAAgC,uEAMnC,CAAC;AACX,eAAO,MAAM,gCAAgC,sDAKnC,CAAC;AACX,eAAO,MAAM,8BAA8B,wDAKjC,CAAC","sourcesContent":["// Code generated from canonical JSON Schemas; DO NOT EDIT.\nexport const ARTIFACT_VALUE_TYPES = [\n  \"text\",\n  \"number\",\n  \"boolean\",\n  \"currency\",\n  \"date\",\n  \"datetime\",\n  \"time\",\n  \"location\",\n  \"file\",\n  \"image\",\n  \"video\",\n  \"audio\",\n  \"link\",\n  \"structured\",\n  \"reference\",\n  \"signature\",\n  \"collection\"\n] as const;\nexport const ARTIFACT_SOURCE_TYPES = [\n  \"inline\",\n  \"local\",\n  \"object\",\n  \"url\",\n  \"hosted\",\n  \"provider\"\n] as const;\nexport const LOCAL_ARTIFACT_SYNC_STATES = [\n  \"local_only\",\n  \"pending_upload\",\n  \"uploading\",\n  \"uploaded\",\n  \"failed\"\n] as const;\nexport const ARTIFACT_INTEGRITY_ALGORITHMS = [\n  \"sha256\",\n  \"sha384\",\n  \"sha512\"\n] as const;\nexport const ARTIFACT_CONDITION_KINDS = [\n  \"state\",\n  \"actor\",\n  \"artifact_exists\",\n  \"artifact_value\",\n  \"and\",\n  \"or\",\n  \"not\"\n] as const;\nexport const ARTIFACT_VALUE_OPERATORS = [\n  \"eq\",\n  \"neq\",\n  \"gt\",\n  \"gte\",\n  \"lt\",\n  \"lte\",\n  \"contains\",\n  \"in\"\n] as const;\nexport const ARTIFACT_PRIVACY_CLASSIFICATIONS = [\n  \"public\",\n  \"internal\",\n  \"private\",\n  \"sensitive\",\n  \"restricted\"\n] as const;\nexport const ARTIFACT_PRIVACY_REPRESENTATIONS = [\n  \"hidden\",\n  \"masked\",\n  \"approximate\",\n  \"full\"\n] as const;\nexport const ARTIFACT_VERIFICATION_STATUSES = [\n  \"pending\",\n  \"verified\",\n  \"rejected\",\n  \"waived\"\n] as const;\n"]}

package/dist/generated/vocabulary.js

@@ -0,0 +1,79 @@
+// Code generated from canonical JSON Schemas; DO NOT EDIT.
+export const ARTIFACT_VALUE_TYPES = [
+    "text",
+    "number",
+    "boolean",
+    "currency",
+    "date",
+    "datetime",
+    "time",
+    "location",
+    "file",
+    "image",
+    "video",
+    "audio",
+    "link",
+    "structured",
+    "reference",
+    "signature",
+    "collection"
+];
+export const ARTIFACT_SOURCE_TYPES = [
+    "inline",
+    "local",
+    "object",
+    "url",
+    "hosted",
+    "provider"
+];
+export const LOCAL_ARTIFACT_SYNC_STATES = [
+    "local_only",
+    "pending_upload",
+    "uploading",
+    "uploaded",
+    "failed"
+];
+export const ARTIFACT_INTEGRITY_ALGORITHMS = [
+    "sha256",
+    "sha384",
+    "sha512"
+];
+export const ARTIFACT_CONDITION_KINDS = [
+    "state",
+    "actor",
+    "artifact_exists",
+    "artifact_value",
+    "and",
+    "or",
+    "not"
+];
+export const ARTIFACT_VALUE_OPERATORS = [
+    "eq",
+    "neq",
+    "gt",
+    "gte",
+    "lt",
+    "lte",
+    "contains",
+    "in"
+];
+export const ARTIFACT_PRIVACY_CLASSIFICATIONS = [
+    "public",
+    "internal",
+    "private",
+    "sensitive",
+    "restricted"
+];
+export const ARTIFACT_PRIVACY_REPRESENTATIONS = [
+    "hidden",
+    "masked",
+    "approximate",
+    "full"
+];
+export const ARTIFACT_VERIFICATION_STATUSES = [
+    "pending",
+    "verified",
+    "rejected",
+    "waived"
+];
+//# sourceMappingURL=vocabulary.js.map

package/dist/generated/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../src/generated/vocabulary.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM;IACN,QAAQ;IACR,SAAS;IACT,UAAU;IACV,MAAM;IACN,UAAU;IACV,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,YAAY;IACZ,WAAW;IACX,WAAW;IACX,YAAY;CACJ,CAAC;AACX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,KAAK;IACL,QAAQ;IACR,UAAU;CACF,CAAC;AACX,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,YAAY;IACZ,gBAAgB;IAChB,WAAW;IACX,UAAU;IACV,QAAQ;CACA,CAAC;AACX,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AACX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO;IACP,OAAO;IACP,iBAAiB;IACjB,gBAAgB;IAChB,KAAK;IACL,IAAI;IACJ,KAAK;CACG,CAAC;AACX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,UAAU;IACV,IAAI;CACI,CAAC;AACX,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,QAAQ;IACR,UAAU;IACV,SAAS;IACT,WAAW;IACX,YAAY;CACJ,CAAC;AACX,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,QAAQ;IACR,QAAQ;IACR,aAAa;IACb,MAAM;CACE,CAAC;AACX,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,SAAS;IACT,UAAU;IACV,UAAU;IACV,QAAQ;CACA,CAAC","sourcesContent":["// Code generated from canonical JSON Schemas; DO NOT EDIT.\nexport const ARTIFACT_VALUE_TYPES = [\n  \"text\",\n  \"number\",\n  \"boolean\",\n  \"currency\",\n  \"date\",\n  \"datetime\",\n  \"time\",\n  \"location\",\n  \"file\",\n  \"image\",\n  \"video\",\n  \"audio\",\n  \"link\",\n  \"structured\",\n  \"reference\",\n  \"signature\",\n  \"collection\"\n] as const;\nexport const ARTIFACT_SOURCE_TYPES = [\n  \"inline\",\n  \"local\",\n  \"object\",\n  \"url\",\n  \"hosted\",\n  \"provider\"\n] as const;\nexport const LOCAL_ARTIFACT_SYNC_STATES = [\n  \"local_only\",\n  \"pending_upload\",\n  \"uploading\",\n  \"uploaded\",\n  \"failed\"\n] as const;\nexport const ARTIFACT_INTEGRITY_ALGORITHMS = [\n  \"sha256\",\n  \"sha384\",\n  \"sha512\"\n] as const;\nexport const ARTIFACT_CONDITION_KINDS = [\n  \"state\",\n  \"actor\",\n  \"artifact_exists\",\n  \"artifact_value\",\n  \"and\",\n  \"or\",\n  \"not\"\n] as const;\nexport const ARTIFACT_VALUE_OPERATORS = [\n  \"eq\",\n  \"neq\",\n  \"gt\",\n  \"gte\",\n  \"lt\",\n  \"lte\",\n  \"contains\",\n  \"in\"\n] as const;\nexport const ARTIFACT_PRIVACY_CLASSIFICATIONS = [\n  \"public\",\n  \"internal\",\n  \"private\",\n  \"sensitive\",\n  \"restricted\"\n] as const;\nexport const ARTIFACT_PRIVACY_REPRESENTATIONS = [\n  \"hidden\",\n  \"masked\",\n  \"approximate\",\n  \"full\"\n] as const;\nexport const ARTIFACT_VERIFICATION_STATUSES = [\n  \"pending\",\n  \"verified\",\n  \"rejected\",\n  \"waived\"\n] as const;\n"]}

package/dist/generated/wire.d.ts

@@ -0,0 +1,497 @@
+export type WireArtifactIntegrity = {
+    "algorithm": "sha256" | "sha384" | "sha512";
+    "hash": string;
+    "size"?: number;
+    "verifiedAt"?: WireArtifactProtocolCommonContractsTimestamp;
+    [key: string]: unknown;
+};
+export type WireArtifactLink = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "id": WireArtifactProtocolCommonContractsArtifactLinkId;
+    "artifactId": WireArtifactProtocolCommonContractsArtifactId;
+    "artifactVersionId"?: WireArtifactProtocolCommonContractsArtifactVersionId;
+    "subject": WireArtifactProtocolCommonContractsArtifactSubjectReference;
+    "role": string;
+    "note"?: string;
+    "createdBy": WireArtifactProtocolCommonContractsActorReference;
+    "createdAt": WireArtifactProtocolCommonContractsTimestamp;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+export type WireArtifactSource = WireInlineArtifactSource | WireLocalArtifactSource | WireObjectArtifactSource | WireUrlArtifactSource | WireHostedArtifactSource | WireProviderArtifactSource;
+export type WireInlineArtifactSource = {
+    "type": "inline";
+    "value": unknown;
+    "mediaType"?: string;
+    [key: string]: unknown;
+};
+export type WireLocalArtifactSource = {
+    "type": "local";
+    "localId": string;
+    "filename"?: string;
+    "mediaType"?: string;
+    "size"?: number;
+    "syncState": "local_only" | "pending_upload" | "uploading" | "uploaded" | "failed";
+    "remoteVersionId"?: WireArtifactProtocolCommonContractsArtifactVersionId;
+    [key: string]: unknown;
+};
+export type WireObjectArtifactSource = {
+    "type": "object";
+    "objectId": string;
+    "filename"?: string;
+    "mediaType"?: string;
+    "size"?: number;
+    "storageProvider"?: string;
+    [key: string]: unknown;
+};
+export type WireUrlArtifactSource = {
+    "type": "url";
+    "url": string;
+    "provider"?: string;
+    "mediaType"?: string;
+    [key: string]: unknown;
+};
+export type WireHostedArtifactSource = {
+    "type": "hosted";
+    "recordType": string;
+    "recordId": string;
+    [key: string]: unknown;
+};
+export type WireProviderArtifactSource = {
+    "type": "provider";
+    "provider": string;
+    "reference": unknown;
+    [key: string]: unknown;
+};
+export type WireArtifactVersion = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "id": WireArtifactProtocolCommonContractsArtifactVersionId;
+    "artifactId": WireArtifactProtocolCommonContractsArtifactId;
+    "version": number;
+    "source": WireArtifactSource;
+    "integrity"?: WireArtifactIntegrity;
+    "createdBy": WireArtifactProtocolCommonContractsActorReference;
+    "createdAt": WireArtifactProtocolCommonContractsTimestamp;
+    "note"?: string;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+export type WireArtifact = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "id": WireArtifactProtocolCommonContractsArtifactId;
+    "scope"?: WireArtifactProtocolCommonContractsArtifactScopeReference;
+    "kind": string;
+    "valueType": WireArtifactProtocolCommonContractsArtifactValueType;
+    "title"?: string;
+    "description"?: string;
+    "currentVersionId"?: WireArtifactProtocolCommonContractsArtifactVersionId;
+    "createdBy": WireArtifactProtocolCommonContractsActorReference;
+    "createdAt": WireArtifactProtocolCommonContractsTimestamp;
+    "updatedAt": WireArtifactProtocolCommonContractsTimestamp;
+    "archivedAt"?: WireArtifactProtocolCommonContractsTimestamp;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+export type WireArtifactAccessPolicy = {
+    "read"?: WireArtifactAccessPolicyRules;
+    "write"?: WireArtifactAccessPolicyRules;
+    "submit"?: WireArtifactAccessPolicyRules;
+    "verify"?: WireArtifactAccessPolicyRules;
+    [key: string]: unknown;
+};
+export type WireArtifactAccessPolicyRules = Array<WireArtifactAccessPolicyRule>;
+export type WireArtifactAccessPolicyRule = {
+    "actors": Array<string>;
+    "condition"?: WireArtifactCondition;
+    [key: string]: unknown;
+};
+/** A language-neutral recursive condition AST. Resolution of host identifiers is host-defined. */
+export type WireArtifactCondition = WireArtifactConditionCondition;
+export type WireArtifactConditionCondition = WireArtifactConditionState | WireArtifactConditionActor | WireArtifactConditionArtifactExists | WireArtifactConditionArtifactValue | WireArtifactConditionAnd | WireArtifactConditionOr | WireArtifactConditionNot;
+export type WireArtifactConditionState = {
+    "kind": "state";
+    "namespace": string;
+    "in": Array<string>;
+    [key: string]: unknown;
+};
+export type WireArtifactConditionActor = {
+    "kind": "actor";
+    "in": Array<string>;
+    [key: string]: unknown;
+};
+export type WireArtifactConditionArtifactExists = {
+    "kind": "artifact_exists";
+    "artifact": string;
+    [key: string]: unknown;
+};
+export type WireArtifactConditionArtifactValue = {
+    "kind": "artifact_value";
+    "artifact": string;
+    "operator": "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "contains" | "in";
+    "value": unknown;
+    [key: string]: unknown;
+};
+export type WireArtifactConditionAnd = {
+    "kind": "and";
+    "conditions": Array<WireArtifactConditionCondition>;
+    [key: string]: unknown;
+};
+export type WireArtifactConditionOr = {
+    "kind": "or";
+    "conditions": Array<WireArtifactConditionCondition>;
+    [key: string]: unknown;
+};
+export type WireArtifactConditionNot = {
+    "kind": "not";
+    "condition": WireArtifactConditionCondition;
+    [key: string]: unknown;
+};
+export type WireArtifactLifecyclePolicy = {
+    "createAt"?: string;
+    "editableDuring"?: Array<string>;
+    "submitDuring"?: Array<string>;
+    "lockAt"?: string;
+    "invalidateOn"?: Array<string>;
+    "condition"?: WireArtifactCondition;
+    [key: string]: unknown;
+};
+export type WireArtifactPresentationPolicy = {
+    "label"?: string;
+    "helpText"?: string;
+    "order"?: number;
+    "display"?: string;
+    "config"?: {
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
+export type WireArtifactPrivacyPolicy = {
+    "classification": "public" | "internal" | "private" | "sensitive" | "restricted";
+    "reveal"?: Array<WireArtifactRevealRule>;
+    "masking"?: WireArtifactMaskingPolicy;
+    "encryption"?: WireArtifactEncryptionPolicy;
+    [key: string]: unknown;
+};
+export type WireArtifactRevealRule = {
+    "actors": Array<string>;
+    "when"?: WireArtifactCondition;
+    "representation": "hidden" | "masked" | "approximate" | "full";
+    [key: string]: unknown;
+};
+export type WireArtifactMaskingPolicy = {
+    "strategy": string;
+    "config"?: {
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
+export type WireArtifactEncryptionPolicy = {
+    "required": boolean;
+    "level"?: string;
+    "keyScope"?: string;
+    [key: string]: unknown;
+};
+export type WireArtifactProviderPolicy = {
+    "actors": Array<string>;
+    "mode"?: "single" | "any" | "all";
+    "delegation"?: "forbidden" | "allowed";
+    [key: string]: unknown;
+};
+export type WireArtifactRequirementPolicy = {
+    "mode": "required" | "optional" | "conditional";
+    "condition"?: WireArtifactCondition;
+    "blocks"?: Array<string>;
+    [key: string]: unknown;
+};
+export type WireArtifactRetentionPolicy = WireArtifactRetentionPolicyForever | WireArtifactRetentionPolicyDuration | WireArtifactRetentionPolicyUntil | WireArtifactRetentionPolicyHostDefined;
+export type WireArtifactRetentionPolicyForever = {
+    "policy": "forever";
+    [key: string]: unknown;
+};
+export type WireArtifactRetentionPolicyDuration = {
+    "policy": "duration";
+    "days": number;
+    [key: string]: unknown;
+};
+export type WireArtifactRetentionPolicyUntil = {
+    "policy": "until";
+    "date": WireArtifactProtocolCommonContractsDate;
+    [key: string]: unknown;
+};
+export type WireArtifactRetentionPolicyHostDefined = {
+    "policy": "host_defined";
+    "key": string;
+    [key: string]: unknown;
+};
+export type WireArtifactValidationPolicy = {
+    "mode"?: "strict" | "lenient";
+    "rules"?: Array<WireArtifactValidationRule>;
+    [key: string]: unknown;
+};
+export type WireArtifactValidationRule = {
+    "type": string;
+    "config"?: {
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
+export type WireArtifactVerificationPolicy = {
+    "required": boolean;
+    "methods"?: Array<string>;
+    "actors"?: Array<string>;
+    "condition"?: WireArtifactCondition;
+    [key: string]: unknown;
+};
+/** The major.minor version of the serialized Artifact Protocol record. */
+export type WireArtifactProtocolCommonContractsSchemaVersion = "1.0";
+/** A non-empty, case-sensitive identifier whose generation and internal form are host-defined. */
+export type WireArtifactProtocolCommonContractsOpaqueIdentifier = string;
+export type WireArtifactProtocolCommonContractsArtifactId = WireArtifactProtocolCommonContractsOpaqueIdentifier;
+export type WireArtifactProtocolCommonContractsArtifactVersionId = WireArtifactProtocolCommonContractsOpaqueIdentifier;
+export type WireArtifactProtocolCommonContractsArtifactLinkId = WireArtifactProtocolCommonContractsOpaqueIdentifier;
+export type WireArtifactProtocolCommonContractsArtifactSpecId = WireArtifactProtocolCommonContractsOpaqueIdentifier;
+export type WireArtifactProtocolCommonContractsArtifactSubmissionId = WireArtifactProtocolCommonContractsOpaqueIdentifier;
+export type WireArtifactProtocolCommonContractsArtifactVerificationId = WireArtifactProtocolCommonContractsOpaqueIdentifier;
+export type WireArtifactProtocolCommonContractsArtifactRequirementId = WireArtifactProtocolCommonContractsOpaqueIdentifier;
+/** An RFC 3339 full-date string. */
+export type WireArtifactProtocolCommonContractsDate = string;
+/** An RFC 3339 date-time string. */
+export type WireArtifactProtocolCommonContractsTimestamp = string;
+export type WireArtifactProtocolCommonContractsArtifactValueType = "text" | "number" | "boolean" | "currency" | "date" | "datetime" | "time" | "location" | "file" | "image" | "video" | "audio" | "link" | "structured" | "reference" | "signature" | "collection";
+export type WireArtifactProtocolCommonContractsActorReference = {
+    "type": string;
+    "id"?: WireArtifactProtocolCommonContractsOpaqueIdentifier;
+    "displayName"?: string;
+    [key: string]: unknown;
+};
+export type WireArtifactProtocolCommonContractsArtifactScopeReference = {
+    "type": string;
+    "id": WireArtifactProtocolCommonContractsOpaqueIdentifier;
+    [key: string]: unknown;
+};
+export type WireArtifactProtocolCommonContractsArtifactSubjectReference = {
+    "type": string;
+    "id": WireArtifactProtocolCommonContractsOpaqueIdentifier;
+    "scope"?: {
+        [key: string]: string;
+    };
+    [key: string]: unknown;
+};
+/** Host extensions represented by arbitrary JSON values. */
+export type WireArtifactProtocolCommonContractsArtifactMetadata = {
+    [key: string]: unknown;
+};
+export type WireArtifactSubmission = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "id": WireArtifactProtocolCommonContractsArtifactSubmissionId;
+    "artifactId": WireArtifactProtocolCommonContractsArtifactId;
+    "artifactVersionId"?: WireArtifactProtocolCommonContractsArtifactVersionId;
+    "submittedBy": WireArtifactProtocolCommonContractsActorReference;
+    "value"?: unknown;
+    "submittedAt": WireArtifactProtocolCommonContractsTimestamp;
+    "context"?: WireArtifactSubmissionContext;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+export type WireArtifactSubmissionContext = {
+    "latitude"?: number;
+    "longitude"?: number;
+    "deviceId"?: string;
+    "ipAddress"?: unknown | unknown;
+    "userAgent"?: string;
+    [key: string]: unknown;
+};
+export type WireArtifactVerification = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "id": WireArtifactProtocolCommonContractsArtifactVerificationId;
+    "artifactId": WireArtifactProtocolCommonContractsArtifactId;
+    "artifactVersionId"?: WireArtifactProtocolCommonContractsArtifactVersionId;
+    "submissionId"?: WireArtifactProtocolCommonContractsArtifactSubmissionId;
+    "status": "pending" | "verified" | "rejected" | "waived";
+    "method"?: string;
+    "verifiedBy"?: WireArtifactProtocolCommonContractsActorReference;
+    "reason"?: string;
+    "createdAt": WireArtifactProtocolCommonContractsTimestamp;
+    "verifiedAt"?: WireArtifactProtocolCommonContractsTimestamp;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+export type WireArtifactRequirement = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "id": WireArtifactProtocolCommonContractsArtifactRequirementId;
+    "key"?: string;
+    "allowedKinds"?: Array<string>;
+    "allowedValueTypes"?: Array<WireArtifactProtocolCommonContractsArtifactValueType>;
+    "minimumCount"?: number;
+    "maximumCount"?: number;
+    "required": boolean;
+    "specId"?: WireArtifactProtocolCommonContractsArtifactSpecId;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+/** An immutable copy of a specification revision captured by a host. */
+export type WireArtifactSpecSnapshot = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "sourceSpecId": WireArtifactProtocolCommonContractsArtifactSpecId;
+    "sourceVersion": number;
+    "key": string;
+    "name": string;
+    "description"?: string;
+    "kind": string;
+    "valueType": WireArtifactProtocolCommonContractsArtifactValueType;
+    "config"?: {
+        "valueType"?: WireArtifactProtocolCommonContractsArtifactValueType;
+        [key: string]: unknown;
+    };
+    "provider"?: WireArtifactProviderPolicy;
+    "requirement"?: WireArtifactRequirementPolicy;
+    "lifecycle"?: WireArtifactLifecyclePolicy;
+    "access"?: WireArtifactAccessPolicy;
+    "privacy"?: WireArtifactPrivacyPolicy;
+    "validation"?: WireArtifactValidationPolicy;
+    "verification"?: WireArtifactVerificationPolicy;
+    "retention"?: WireArtifactRetentionPolicy;
+    "presentation"?: WireArtifactPresentationPolicy;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+export type WireArtifactSpec = {
+    "schemaVersion": WireArtifactProtocolCommonContractsSchemaVersion;
+    "id": WireArtifactProtocolCommonContractsArtifactSpecId;
+    "key": string;
+    "name": string;
+    "description"?: string;
+    "version": number;
+    "kind": string;
+    "valueType": WireArtifactProtocolCommonContractsArtifactValueType;
+    "config"?: {
+        "valueType"?: WireArtifactProtocolCommonContractsArtifactValueType;
+        [key: string]: unknown;
+    };
+    "provider"?: WireArtifactProviderPolicy;
+    "requirement"?: WireArtifactRequirementPolicy;
+    "lifecycle"?: WireArtifactLifecyclePolicy;
+    "access"?: WireArtifactAccessPolicy;
+    "privacy"?: WireArtifactPrivacyPolicy;
+    "validation"?: WireArtifactValidationPolicy;
+    "verification"?: WireArtifactVerificationPolicy;
+    "retention"?: WireArtifactRetentionPolicy;
+    "presentation"?: WireArtifactPresentationPolicy;
+    "metadata"?: WireArtifactProtocolCommonContractsArtifactMetadata;
+    [key: string]: unknown;
+};
+/** Standardized representation constraints. Artifact kind remains a separate host-defined semantic identifier. */
+export type WireArtifactValueSchema = WireArtifactValueSchemaText | WireArtifactValueSchemaNumber | WireArtifactValueSchemaBoolean | WireArtifactValueSchemaCurrency | WireArtifactValueSchemaDate | WireArtifactValueSchemaDatetime | WireArtifactValueSchemaTime | WireArtifactValueSchemaLocation | WireArtifactValueSchemaFile | WireArtifactValueSchemaImage | WireArtifactValueSchemaVideo | WireArtifactValueSchemaAudio | WireArtifactValueSchemaLink | WireArtifactValueSchemaStructured | WireArtifactValueSchemaReference | WireArtifactValueSchemaSignature | WireArtifactValueSchemaCollection;
+export type WireArtifactValueSchemaText = {
+    "valueType": "text";
+    "minLength"?: number;
+    "maxLength"?: number;
+    "multiline"?: boolean;
+    "pattern"?: string;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaNumber = {
+    "valueType": "number";
+    "minimum"?: number;
+    "maximum"?: number;
+    "integer"?: boolean;
+    "multipleOf"?: number;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaBoolean = {
+    "valueType": "boolean";
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaCurrency = {
+    "valueType": "currency";
+    "currencies"?: Array<string>;
+    "minimumMinorUnits"?: number;
+    "maximumMinorUnits"?: number;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaDate = {
+    "valueType": "date";
+    "minimum"?: WireArtifactProtocolCommonContractsDate;
+    "maximum"?: WireArtifactProtocolCommonContractsDate;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaDatetime = {
+    "valueType": "datetime";
+    "minimum"?: WireArtifactProtocolCommonContractsTimestamp;
+    "maximum"?: WireArtifactProtocolCommonContractsTimestamp;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaTime = {
+    "valueType": "time";
+    "minimum"?: string;
+    "maximum"?: string;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaLocation = {
+    "valueType": "location";
+    "mode": "point" | "address" | "point_and_address";
+    "requireCoordinates"?: boolean;
+    "allowManualEntry"?: boolean;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaFile = WireArtifactValueSchemaFileBase & {
+    "valueType": "file";
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaImage = WireArtifactValueSchemaFileBase & {
+    "valueType": "image";
+    "requireTimestamp"?: boolean;
+    "requireLocation"?: boolean;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaVideo = WireArtifactValueSchemaFileBase & {
+    "valueType": "video";
+    "maxDurationSeconds"?: number;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaAudio = WireArtifactValueSchemaFileBase & {
+    "valueType": "audio";
+    "maxDurationSeconds"?: number;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaFileBase = {
+    "minFiles"?: number;
+    "maxFiles"?: number;
+    "acceptedMimeTypes"?: Array<string>;
+    "maxSizeBytes"?: number;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaLink = {
+    "valueType": "link";
+    "allowedSchemes"?: Array<string>;
+    "allowedHosts"?: Array<string>;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaStructured = {
+    "valueType": "structured";
+    "jsonSchema"?: {
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaReference = {
+    "valueType": "reference";
+    "providers"?: Array<string>;
+    "resourceTypes"?: Array<string>;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaSignature = {
+    "valueType": "signature";
+    "methods"?: Array<string>;
+    "requireTimestamp"?: boolean;
+    [key: string]: unknown;
+};
+export type WireArtifactValueSchemaCollection = {
+    "valueType": "collection";
+    "itemSchema": WireArtifactValueSchema;
+    "minItems"?: number;
+    "maxItems"?: number;
+    "uniqueItems"?: boolean;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=wire.d.ts.map