ModelArtifact · types

The following types define named objects and their relationships. Tables include inherited properties. Schema-derived types refer to their validated structures; a TypeScript declaration does not replace the compiler’s semantic checks.

ModelSourceSnapshot

Immutable source snapshot stored separately from its compiled artifact.

Field	Options / expected values	Description
contract	"ModelSourceSnapshot@1"	Required. Exact discriminant of this contract variant. Match the literal value shown.
modelId	string	Required. Defines model Id for this object. Observe the type, variants and bounds in the Options column.
version	string	Required. Declared content or publication version identifying the applicable interpretation.
commit	string	Required. Source revision identity associated with compilation.
subdirectory	string	Required. Source package subdirectory within the distribution repository.
files	readonly { path: string; content: string; }[]	Required. Defines files for this object. Observe the type, variants and bounds in the Options column.
sourceHash	string	Required. Digest of the source used to produce the artifact.

export interface ModelSourceSnapshot {
  contract: 'ModelSourceSnapshot@1';
  modelId: string;
  version: string;
  commit: string;
  subdirectory: string;
  files: readonly { path: string; content: string }[];
  sourceHash: string;
}

ModelArtifact

Runtime artifact accepted by Model Distribution and Surface Core.

Field	Options / expected values	Description
contract	"ModelArtifact@1"	Required. Exact discriminant of this contract variant. Match the literal value shown.
artifactHash	string	Required. Artifact content digest that must match its provenance.
sourceHash	string	Required. Digest of the source used to produce the artifact.
model	ManagedModelSource	Required. Defines model for this object. Observe the type, variants and bounds in the Options column.

export interface ModelArtifact {
  contract: 'ModelArtifact@1';
  artifactHash: string;
  sourceHash: string;
  model: ManagedModelSource;
}

CompiledManagedModel

Complete deterministic compilation output for one managed Model directory.

Field	Options / expected values	Description
snapshot	ModelSourceSnapshot	Required. Defines snapshot for this object. Observe the type, variants and bounds in the Options column.
artifact	ModelArtifact	Required. Defines artifact for this object. Observe the type, variants and bounds in the Options column.

export interface CompiledManagedModel {
  snapshot: ModelSourceSnapshot;
  artifact: ModelArtifact;
}

All references

Applied examples : Publish a reusable app

Publication describes the app; policies preserve access to instance Actions.

Configuration

Fragment placed in publication. Properties and accepted values.

{
  "kind": "workspace-application",
  "license": "Proprietary",
  "requiredCapabilities": [],
  "requiredConnections": []
}

Variation and connection

Fragment placed in contentActions[]. Properties and accepted values.

{
  "contract": "ContentSpaceActionPolicy@1",
  "spaceKey": "clients",
  "actionKey": "prepare-quote",
  "minimumRole": "editor"
}

UI layout example

The illustrative layout below places this configuration in the Clients/Quotes app. Insert each fragment at the stated location, with Field, Query and Action references matching the Model declarations.

1. Target object
2. Proposed change
3. Checks
4. Confirm

SurfaceClients / North StudioExample

ModelArtifact · typesPublish a reusable app

Clients

NS

North StudioQuote S-1042

Needs review

Proposed change

Publication describes the app; policies preserve access to instance Actions.

Data and references

Client · Need · Pricing

BackReview then confirm