@meshery/schemas 1.3.107 → 1.3.109

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/dist/cloudApi.d.mts +8651 -4670
  2. package/dist/cloudApi.d.ts +8651 -4670
  3. package/dist/cloudApi.js +1 -1
  4. package/dist/cloudApi.mjs +1 -1
  5. package/dist/constructs/v1beta3/academy/Academy.d.ts +9 -3
  6. package/dist/constructs/v1beta3/academy/AcademySchema.js +2 -2
  7. package/dist/constructs/v1beta3/academy/AcademySchema.mjs +2 -2
  8. package/dist/constructs/v1beta3/content_item/ContentItem.d.ts +682 -33
  9. package/dist/constructs/v1beta3/content_item/ContentItemSchema.js +215 -22
  10. package/dist/constructs/v1beta3/content_item/ContentItemSchema.mjs +215 -22
  11. package/dist/constructs/v1beta3/invitation/Invitation.d.ts +30 -10
  12. package/dist/constructs/v1beta3/invitation/InvitationSchema.js +1 -1
  13. package/dist/constructs/v1beta3/invitation/InvitationSchema.mjs +1 -1
  14. package/dist/constructs/v1beta3/media_asset/MediaAsset.d.ts +2322 -0
  15. package/dist/constructs/v1beta3/media_asset/MediaAssetSchema.d.ts +2 -0
  16. package/dist/constructs/v1beta3/media_asset/MediaAssetSchema.js +61 -0
  17. package/dist/constructs/v1beta3/media_asset/MediaAssetSchema.mjs +61 -0
  18. package/dist/constructs/v1beta3/mention_alias/MentionAlias.d.ts +678 -0
  19. package/dist/constructs/v1beta3/mention_alias/MentionAlias.js +1 -0
  20. package/dist/constructs/v1beta3/mention_alias/MentionAlias.mjs +0 -0
  21. package/dist/constructs/v1beta3/mention_alias/MentionAliasSchema.d.ts +2 -0
  22. package/dist/constructs/v1beta3/mention_alias/MentionAliasSchema.js +75 -0
  23. package/dist/constructs/v1beta3/mention_alias/MentionAliasSchema.mjs +75 -0
  24. package/dist/constructs/v1beta3/{risk_profile/RiskProfile.d.ts → posture/Posture.d.ts} +7 -7
  25. package/dist/constructs/v1beta3/posture/Posture.js +1 -0
  26. package/dist/constructs/v1beta3/posture/Posture.mjs +0 -0
  27. package/dist/constructs/v1beta3/posture/PostureSchema.d.ts +2 -0
  28. package/dist/constructs/v1beta3/posture/PostureSchema.js +22 -0
  29. package/dist/constructs/v1beta3/posture/PostureSchema.mjs +22 -0
  30. package/dist/constructs/v1beta3/schedule/Schedule.d.ts +41 -41
  31. package/dist/constructs/v1beta3/schedule/ScheduleSchema.js +23 -23
  32. package/dist/constructs/v1beta3/schedule/ScheduleSchema.mjs +23 -23
  33. package/dist/index.d.mts +23 -1
  34. package/dist/index.d.ts +23 -1
  35. package/dist/index.js +2 -2
  36. package/dist/index.mjs +2 -2
  37. package/package.json +1 -1
  38. package/dist/constructs/v1beta3/risk_profile/RiskProfileSchema.d.ts +0 -2
  39. package/dist/constructs/v1beta3/risk_profile/RiskProfileSchema.js +0 -22
  40. package/dist/constructs/v1beta3/risk_profile/RiskProfileSchema.mjs +0 -22
  41. /package/dist/constructs/v1beta3/{risk_profile/RiskProfile.js → media_asset/MediaAsset.js} +0 -0
  42. /package/dist/constructs/v1beta3/{risk_profile/RiskProfile.mjs → media_asset/MediaAsset.mjs} +0 -0
@@ -1,6 +1,11 @@
1
1
  'use strict';var e={openapi:"3.0.0",info:{title:"ContentItem",description:`OpenAPI schema for content items - fingerprinted content
2
2
  values keyed by organization and row number, with conditional
3
3
  updates.
4
+ A content item may carry its own rules of engagement
5
+ (\`rulesOfEngagement\`), which can only tighten the rules its profile and
6
+ platform run under, and may belong to a thread (\`threadId\`,
7
+ \`replyToId\`, \`threadIndex\`): the parts of a split post, or the replies
8
+ of a conversation between profiles.
4
9
  Organization scope: every operation acts only in the organization the
5
10
  session resolved to (X-Current-Orgid, then the user's selected
6
11
  organization), and only when the caller is a live member of it.
@@ -12,12 +17,58 @@ Delete Content Item for the writes); a caller without it receives a
12
17
  a live content item of the organization, and a caller who is not a
13
18
  live member of it, receive the same 404, so the existence of another
14
19
  organization's rows is never disclosed.
15
- `,version:"v1beta3",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"contentItems",description:"Operations related to content items."}],paths:{"/api/content-items":{get:{"x-internal":["cloud"],tags:["contentItems"],summary:"List content items",operationId:"listContentItems",description:"Returns a paginated list of the live content items in the\norganization of the authenticated session, ordered by `rowNumber`\nunless `order` names another column (`rowNumber`, `createdAt`,\n`updatedAt`). `search` matches the profile or the content values,\ncase-insensitively.\n",parameters:[{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}},{name:"profile",in:"query",required:false,description:"Filter by owning profile subject (exact match).",schema:{type:"string"}}],responses:{200:{description:"Content item page",content:{"application/json":{schema:{type:"object",description:"Paginated collection of content items.",properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},contentItems:{type:"array",items:{"x-go-type":"ContentItem",$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
20
+ `,version:"v1beta3",contact:{name:"Meshery Maintainers",email:"maintainers@meshery.io",url:"https://meshery.io"},license:{name:"Apache 2.0",url:"https://www.apache.org/licenses/LICENSE-2.0.html"}},security:[{jwt:[]}],tags:[{name:"contentItems",description:"Operations related to content items."}],paths:{"/api/content-items":{get:{"x-internal":["cloud"],tags:["contentItems"],summary:"List content items",operationId:"listContentItems",description:"Returns a paginated list of the live content items in the\norganization of the authenticated session, ordered by `rowNumber`\nunless `order` names another column (`rowNumber`, `createdAt`,\n`updatedAt`). `search` matches the profile or the content values,\ncase-insensitively. `threadId` returns one whole thread: the root\nitem it names and every live item whose `threadId` names it,\nordered by `threadIndex` (the root first) unless `order` names\nanother column.\n",parameters:[{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}},{name:"profile",in:"query",required:false,description:"Filter by owning profile subject (exact match).",schema:{type:"string"}},{name:"threadId",in:"query",required:false,description:"Return one thread: the root item this ID names and every live item\nwhose `threadId` names it.\n",schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],responses:{200:{description:"Content item page",content:{"application/json":{schema:{type:"object",description:"Paginated collection of content items.",properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},contentItems:{type:"array",items:{"x-go-type":"ContentItem",$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
16
21
  Content items carry a row number and a server-computed fingerprint over
17
22
  their canonical values; updates are conditional on the fingerprint the
18
23
  writer read, so stale writes are refused rather than silently applied.
19
- `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{description:"Server-generated content item ID.","x-oapi-codegen-extra-tags":{db:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},organizationId:{description:"Owning organization ID. Derived from the authenticated session, never client-settable.","x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values, typed so null, empty string, zero and false differ. Server-computed; used for conditional updates.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{description:`ID of the user whose session created the content item. Derived from the authenticated session, never client-settable, and never changed by an update. Omitted on content items created before it was recorded, and when that user was later purged.
20
- `,"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}},description:"Content items included on this page of results."}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},post:{"x-internal":["cloud"],tags:["contentItems"],summary:"Insert a content item",operationId:"insertContentItem",description:"Inserts a new content item. Insert-only: any supplied\n`id` and `expectedFingerprint` are ignored; existing rows change\nonly through the conditional `updateContentItem`. The\n`fingerprint` is server-computed. Row numbers are unique across\nthe live content items of the organization, whatever their\n`profile`. When `rowNumber` is omitted the server assigns the next\nrow number of the organization (one more than the highest row\nnumber the organization has used, counting soft-deleted content\nitems so a deleted item's number is not handed out again by\nassignment), atomically with the insert, so\nconcurrent inserts never receive the same number. An organization\nthat has never had a content item is assigned row number 1 first\n(an explicit `rowNumber` of 0 is still accepted). A supplied\n`rowNumber` that another live content item of the organization\nalready holds refuses the insert with a 409.\n",requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],properties:{id:{description:"Existing content item ID for updates; ignored on insert.","x-oapi-codegen-extra-tags":{json:"id,omitempty"},type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
24
+ An item may carry its own rules of engagement, which can only tighten,
25
+ and may belong to a thread through \`threadId\`, \`replyToId\` and
26
+ \`threadIndex\`. See docs/content-item-contract.md.
27
+ `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
28
+ `,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
29
+ least as cautious as the preset its profile and platform
30
+ resolve to.
31
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
32
+ changed; present, the item's rules read as adjusted.
33
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
34
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
35
+ `,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}},description:"Content items included on this page of results."}}}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},post:{"x-internal":["cloud"],tags:["contentItems"],summary:"Insert a content item",operationId:"insertContentItem",description:`Inserts a new content item. Insert-only: any supplied
36
+ \`id\` and \`expectedFingerprint\` are ignored; existing rows change
37
+ only through the conditional \`updateContentItem\`. The
38
+ \`fingerprint\` is server-computed. Row numbers are unique across
39
+ the live content items of the organization, whatever their
40
+ \`profile\`. When \`rowNumber\` is omitted the server assigns the next
41
+ row number of the organization (one more than the highest row
42
+ number the organization has used, counting soft-deleted content
43
+ items so a deleted item's number is not handed out again by
44
+ assignment), atomically with the insert, so
45
+ concurrent inserts never receive the same number. An organization
46
+ that has never had a content item is assigned row number 1 first
47
+ (an explicit \`rowNumber\` of 0 is still accepted). A supplied
48
+ \`rowNumber\` that another live content item of the organization
49
+ already holds refuses the insert with a 409.
50
+ A \`rulesOfEngagement\` outside its schema (an unknown preset or
51
+ dial, or a value out of range) is refused with a 400, on insert
52
+ and on update alike.
53
+ Each \`mediaAssetIds\` entry must name a media asset of the session
54
+ organization, else 400 (the same 400 for a missing, another
55
+ organization's and a deleted asset), on insert and on update alike.
56
+ The server does not require the asset to be ready at write time:
57
+ deleting an asset does not check content item references, and such
58
+ an item is refused by name when it posts, so the posting client
59
+ checks readiness.
60
+ Thread fields are checked against the organization's live content
61
+ items in the same transaction as the insert, and a violation is
62
+ refused with a 400: \`threadId\` must name a live item of the
63
+ organization that is not itself part of a thread; \`replyToId\`
64
+ requires \`threadId\` and must name that root or a live item of the
65
+ same thread; \`threadIndex\` is required exactly when \`threadId\` is
66
+ given and must exceed the position of the item \`replyToId\` names
67
+ (the root counts as 0). An item of another organization, a deleted
68
+ item and a missing one receive the same 400. A \`threadIndex\` that
69
+ another live item of the same thread already holds refuses the
70
+ insert with a 409.
71
+ `,requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{json:"id,omitempty"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
21
72
  items of the organization. Optional: omitted on insert, the
22
73
  server assigns the next row number of the organization; omitted
23
74
  on update, the stored row number is kept.
@@ -25,17 +76,63 @@ on update, the stored row number is kept.
25
76
  the update applies only when the stored fingerprint still
26
77
  matches, and is refused with a 409 otherwise. Ignored on
27
78
  insert.
28
- `,maxLength:255}}}}}},responses:{201:{description:"Content item created",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
79
+ `,maxLength:255},rulesOfEngagement:{allOf:[{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
80
+ optionally, dials changed for this item only. Every value can only
81
+ tighten. The client that runs the item resolves the effective rules
82
+ as the stricter of these and the rules that apply to its profile and
83
+ platform without them (the more cautious preset wins, and each dial
84
+ applies only where it is stricter than the resolved preset's own);
85
+ the warm-up and the pause after a sign-in challenge always apply.
86
+ The server validates the shape and stores the value as given; it
87
+ never resolves or loosens it.
88
+ `,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
89
+ least as cautious as the preset its profile and platform
90
+ resolve to.
91
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
92
+ changed; present, the item's rules read as adjusted.
93
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}}],description:`The item's own rules of engagement, which can only tighten the
94
+ rules its profile and platform run under. Omitted on insert, the
95
+ item has none; omitted on update, the stored rules are kept;
96
+ \`null\` on update clears them.
97
+ `,nullable:true,"x-oapi-codegen-extra-tags":{json:"rulesOfEngagement,omitempty"}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the thread's root item. Read on insert; on update it must
98
+ be omitted or equal the stored value.
99
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{json:"threadId,omitempty"}},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the root named by\n`threadId` or an item of the same thread. Requires `threadId`.\nRead on insert; on update it must be omitted or equal the stored\nvalue.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{json:"replyToId,omitempty"}},threadIndex:{type:"integer",description:`Position of the item in its thread, the root counting as 0.
100
+ Required exactly when \`threadId\` is given. Read on insert; on
101
+ update it must be omitted or equal the stored value.
102
+ `,minimum:1},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Omitted on
103
+ insert means none; omitted on update keeps the stored list (old
104
+ clients send the whole item without it); an empty array clears it.
105
+ `,"x-oapi-codegen-extra-tags":{json:"mediaAssetIds,omitempty"}}}}}}},responses:{201:{description:"Content item created",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
29
106
  Content items carry a row number and a server-computed fingerprint over
30
107
  their canonical values; updates are conditional on the fingerprint the
31
108
  writer read, so stale writes are refused rather than silently applied.
32
- `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{description:"Server-generated content item ID.","x-oapi-codegen-extra-tags":{db:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},organizationId:{description:"Owning organization ID. Derived from the authenticated session, never client-settable.","x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values, typed so null, empty string, zero and false differ. Server-computed; used for conditional updates.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{description:`ID of the user whose session created the content item. Derived from the authenticated session, never client-settable, and never changed by an update. Omitted on content items created before it was recorded, and when that user was later purged.
33
- `,"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, or another live content item of the organization already holds the same rowNumber",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/content-items/{contentItemId}":{get:{"x-internal":["cloud"],tags:["contentItems"],summary:"Get a content item by ID",operationId:"getContentItem",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],responses:{200:{description:"Content item response",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
109
+ An item may carry its own rules of engagement, which can only tighten,
110
+ and may belong to a thread through \`threadId\`, \`replyToId\` and
111
+ \`threadIndex\`. See docs/content-item-contract.md.
112
+ `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
113
+ `,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
114
+ least as cautious as the preset its profile and platform
115
+ resolve to.
116
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
117
+ changed; present, the item's rules read as adjusted.
118
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
119
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
120
+ `,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}},"/api/content-items/{contentItemId}":{get:{"x-internal":["cloud"],tags:["contentItems"],summary:"Get a content item by ID",operationId:"getContentItem",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],responses:{200:{description:"Content item response",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
34
121
  Content items carry a row number and a server-computed fingerprint over
35
122
  their canonical values; updates are conditional on the fingerprint the
36
123
  writer read, so stale writes are refused rather than silently applied.
37
- `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{description:"Server-generated content item ID.","x-oapi-codegen-extra-tags":{db:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},organizationId:{description:"Owning organization ID. Derived from the authenticated session, never client-settable.","x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values, typed so null, empty string, zero and false differ. Server-computed; used for conditional updates.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{description:`ID of the user whose session created the content item. Derived from the authenticated session, never client-settable, and never changed by an update. Omitted on content items created before it was recorded, and when that user was later purged.
38
- `,"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},put:{"x-internal":["cloud"],tags:["contentItems"],summary:"Update a content item",operationId:"updateContentItem",description:"Conditionally updates the content item. When\n`expectedFingerprint` is supplied and stale, the update is\nrefused with a 409, as is an update that would move the item\nonto a `rowNumber` another live content item of the organization\nholds. An omitted `rowNumber` keeps the stored one.\n",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],properties:{id:{description:"Existing content item ID for updates; ignored on insert.","x-oapi-codegen-extra-tags":{json:"id,omitempty"},type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
124
+ An item may carry its own rules of engagement, which can only tighten,
125
+ and may belong to a thread through \`threadId\`, \`replyToId\` and
126
+ \`threadIndex\`. See docs/content-item-contract.md.
127
+ `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
128
+ `,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
129
+ least as cautious as the preset its profile and platform
130
+ resolve to.
131
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
132
+ changed; present, the item's rules read as adjusted.
133
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
134
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
135
+ `,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},put:{"x-internal":["cloud"],tags:["contentItems"],summary:"Update a content item",operationId:"updateContentItem",description:"Conditionally updates the content item. When\n`expectedFingerprint` is supplied and stale, the update is\nrefused with a 409, as is an update that would move the item\nonto a `rowNumber` another live content item of the organization\nholds. An omitted `rowNumber` keeps the stored one.\nAn omitted `rulesOfEngagement` keeps the stored rules and `null`\nclears them, so a writer that does not know the field never erases\nit. An omitted `mediaAssetIds` keeps the stored list and `[]`\nclears it. The thread fields are fixed at insert: omitted, or equal to the\nstored values, they are kept; any other value is refused with a 400.\n",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}],requestBody:{required:true,content:{"application/json":{schema:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{json:"id,omitempty"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
39
136
  items of the organization. Optional: omitted on insert, the
40
137
  server assigns the next row number of the organization; omitted
41
138
  on update, the stored row number is kept.
@@ -43,25 +140,67 @@ on update, the stored row number is kept.
43
140
  the update applies only when the stored fingerprint still
44
141
  matches, and is refused with a 409 otherwise. Ignored on
45
142
  insert.
46
- `,maxLength:255}}}}}},responses:{200:{description:"Content item updated",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
143
+ `,maxLength:255},rulesOfEngagement:{allOf:[{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
144
+ optionally, dials changed for this item only. Every value can only
145
+ tighten. The client that runs the item resolves the effective rules
146
+ as the stricter of these and the rules that apply to its profile and
147
+ platform without them (the more cautious preset wins, and each dial
148
+ applies only where it is stricter than the resolved preset's own);
149
+ the warm-up and the pause after a sign-in challenge always apply.
150
+ The server validates the shape and stores the value as given; it
151
+ never resolves or loosens it.
152
+ `,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
153
+ least as cautious as the preset its profile and platform
154
+ resolve to.
155
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
156
+ changed; present, the item's rules read as adjusted.
157
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}}],description:`The item's own rules of engagement, which can only tighten the
158
+ rules its profile and platform run under. Omitted on insert, the
159
+ item has none; omitted on update, the stored rules are kept;
160
+ \`null\` on update clears them.
161
+ `,nullable:true,"x-oapi-codegen-extra-tags":{json:"rulesOfEngagement,omitempty"}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the thread's root item. Read on insert; on update it must
162
+ be omitted or equal the stored value.
163
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{json:"threadId,omitempty"}},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the root named by\n`threadId` or an item of the same thread. Requires `threadId`.\nRead on insert; on update it must be omitted or equal the stored\nvalue.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{json:"replyToId,omitempty"}},threadIndex:{type:"integer",description:`Position of the item in its thread, the root counting as 0.
164
+ Required exactly when \`threadId\` is given. Read on insert; on
165
+ update it must be omitted or equal the stored value.
166
+ `,minimum:1},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Omitted on
167
+ insert means none; omitted on update keeps the stored list (old
168
+ clients send the whole item without it); an empty array clears it.
169
+ `,"x-oapi-codegen-extra-tags":{json:"mediaAssetIds,omitempty"}}}}}}},responses:{200:{description:"Content item updated",content:{"application/json":{schema:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
47
170
  Content items carry a row number and a server-computed fingerprint over
48
171
  their canonical values; updates are conditional on the fingerprint the
49
172
  writer read, so stale writes are refused rather than silently applied.
50
- `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{description:"Server-generated content item ID.","x-oapi-codegen-extra-tags":{db:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},organizationId:{description:"Owning organization ID. Derived from the authenticated session, never client-settable.","x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values, typed so null, empty string, zero and false differ. Server-computed; used for conditional updates.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{description:`ID of the user whose session created the content item. Derived from the authenticated session, never client-settable, and never changed by an update. Omitted on content items created before it was recorded, and when that user was later purged.
51
- `,"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, or another live content item of the organization already holds the same rowNumber",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},delete:{"x-internal":["cloud"],tags:["contentItems"],summary:"Delete a content item",operationId:"deleteContentItem",description:`Soft-deletes the content item. When \`expectedFingerprint\` is
52
- supplied, the delete applies only when the stored fingerprint
53
- still matches and is refused with a 409 otherwise; without it the
54
- delete is unconditional.
55
- `,parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},{name:"expectedFingerprint",in:"query",description:`Optional optimistic-concurrency precondition for delete: the
173
+ An item may carry its own rules of engagement, which can only tighten,
174
+ and may belong to a thread through \`threadId\`, \`replyToId\` and
175
+ \`threadIndex\`. See docs/content-item-contract.md.
176
+ `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
177
+ `,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
178
+ least as cautious as the preset its profile and platform
179
+ resolve to.
180
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
181
+ changed; present, the item's rules read as adjusted.
182
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
183
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
184
+ `,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}}}}},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}},delete:{"x-internal":["cloud"],tags:["contentItems"],summary:"Delete a content item",operationId:"deleteContentItem",description:"Soft-deletes the content item. When `expectedFingerprint` is\nsupplied, the delete applies only when the stored fingerprint\nstill matches and is refused with a 409 otherwise; without it the\ndelete is unconditional. Deleting an item that other items name in\n`threadId` or `replyToId` leaves their references as they are.\n",parameters:[{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},{name:"expectedFingerprint",in:"query",description:`Optional optimistic-concurrency precondition for delete: the
56
185
  delete applies only when the stored fingerprint still matches.
57
- `,required:false,schema:{type:"string",maxLength:255}}],responses:{204:{description:"Content item deleted"},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, or another live content item of the organization already holds the same rowNumber",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"Bearer [REDACTED]",bearerFormat:"JWT"}},responses:{400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, or another live content item of the organization already holds the same rowNumber",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}},MeshkitError429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}},parameters:{expectedFingerprint:{name:"expectedFingerprint",in:"query",description:`Optional optimistic-concurrency precondition for delete: the
186
+ `,required:false,schema:{type:"string",maxLength:255}}],responses:{204:{description:"Content item deleted"},400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",content:{"text/plain":{schema:{type:"string"}}}},429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}}}}}},components:{securitySchemes:{jwt:{type:"http",scheme:"Bearer [REDACTED]",bearerFormat:"JWT"}},responses:{400:{description:"Invalid request body or request param",content:{"text/plain":{schema:{type:"string"}}}},401:{description:"Expired JWT token used or insufficient privilege",content:{"text/plain":{schema:{type:"string"}}}},403:{description:"Forbidden",content:{"text/plain":{schema:{type:"string"}}}},404:{description:"Result not found",content:{"text/plain":{schema:{type:"string"}}}},409:{description:"Conflict - the stale expectedFingerprint precondition no longer matches the stored content fingerprint, another live content item of the organization already holds the same rowNumber, or another live item of the same thread already holds the same threadIndex",content:{"text/plain":{schema:{type:"string"}}}},500:{description:"Internal server error",content:{"text/plain":{schema:{type:"string"}}}},MeshkitError429:{description:"Too many requests - the caller exceeded the server's per-user request rate for this route family. Wait the number of seconds in `Retry-After` before retrying.",headers:{"Retry-After":{description:"Number of seconds the caller must wait before retrying.",required:true,schema:{type:"integer",minimum:1}}},content:{"application/json":{schema:{type:"object",description:"A MeshKit error answered as a JSON body. `error` is the sentence the caller is shown; MeshKit's long description is never serialized. Use the `MeshkitError400`, `MeshkitError403`, `MeshkitError404`, `MeshkitError409`, `MeshkitError429`, `MeshkitError500` and `MeshkitError502` responses for an operation whose server answers its refusals this way.",required:["error"],additionalProperties:false,properties:{error:{type:"string",minLength:1,description:"The sentence the caller is shown."},code:{type:"string",minLength:1,description:"MeshKit error code, a component-scoped identifier allocated by the emitting service (e.g. `<component>-<number>`); it is not a stable part of this contract. Omitted for an error that is not a MeshKit error."},severity:{type:"string",description:"MeshKit severity name. Omitted when MeshKit reports none.",enum:["emergency","alert","critical","fatal"]},probableCause:{type:"array",description:"MeshKit's probable causes of the error.",items:{type:"string"}},suggestedRemediation:{type:"array",description:"MeshKit's suggested remediations for the error.",items:{type:"string"}}}}}}}},parameters:{expectedFingerprint:{name:"expectedFingerprint",in:"query",description:`Optional optimistic-concurrency precondition for delete: the
58
187
  delete applies only when the stored fingerprint still matches.
59
- `,required:false,schema:{type:"string",maxLength:255}},contentItemId:{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},page:{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},pageSize:{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},pagesize:{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},search:{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},order:{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}}},schemas:{ContentItem:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
188
+ `,required:false,schema:{type:"string",maxLength:255}},threadId:{name:"threadId",in:"query",required:false,description:"Return one thread: the root item this ID names and every live item\nwhose `threadId` names it.\n",schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},contentItemId:{name:"contentItemId",in:"path",description:"Content item ID",required:true,schema:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}},page:{name:"page",in:"query",description:"Get responses by page",schema:{type:"integer",minimum:0}},pageSize:{name:"pageSize",in:"query",description:"Number of items per page (canonical camelCase form).",schema:{type:"integer",minimum:1}},pagesize:{name:"pagesize",in:"query",description:"Number of items per page. Deprecated alias of pageSize;\ncanonical `pageSize` wins when both are present.\n",deprecated:true,schema:{type:"integer",minimum:1}},search:{name:"search",in:"query",description:"Get responses that match search param value",schema:{type:"string"}},order:{name:"order",in:"query",description:"Get ordered responses",schema:{type:"string"}}},schemas:{ContentItem:{$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
60
189
  Content items carry a row number and a server-computed fingerprint over
61
190
  their canonical values; updates are conditional on the fingerprint the
62
191
  writer read, so stale writes are refused rather than silently applied.
63
- `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{description:"Server-generated content item ID.","x-oapi-codegen-extra-tags":{db:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},organizationId:{description:"Owning organization ID. Derived from the authenticated session, never client-settable.","x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values, typed so null, empty string, zero and false differ. Server-computed; used for conditional updates.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{description:`ID of the user whose session created the content item. Derived from the authenticated session, never client-settable, and never changed by an update. Omitted on content items created before it was recorded, and when that user was later purged.
64
- `,"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}},ContentItemPayload:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],properties:{id:{description:"Existing content item ID for updates; ignored on insert.","x-oapi-codegen-extra-tags":{json:"id,omitempty"},type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
192
+ An item may carry its own rules of engagement, which can only tighten,
193
+ and may belong to a thread through \`threadId\`, \`replyToId\` and
194
+ \`threadIndex\`. See docs/content-item-contract.md.
195
+ `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
196
+ `,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
197
+ least as cautious as the preset its profile and platform
198
+ resolve to.
199
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
200
+ changed; present, the item's rules read as adjusted.
201
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
202
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
203
+ `,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}},ContentItemPayload:{type:"object",description:"Payload for inserting or updating a content item.\nContains only client-settable fields; the owning\n`organizationId` (derived from the authenticated session), the\nserver-computed `fingerprint` and the server-generated\n`createdAt` / `updatedAt` timestamps are intentionally excluded.\n",required:["profile"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{json:"id,omitempty"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255},rowNumber:{type:"integer",description:`Row number of the content item, unique across the live content
65
204
  items of the organization. Optional: omitted on insert, the
66
205
  server assigns the next row number of the organization; omitted
67
206
  on update, the stored row number is kept.
@@ -69,9 +208,63 @@ on update, the stored row number is kept.
69
208
  the update applies only when the stored fingerprint still
70
209
  matches, and is refused with a 409 otherwise. Ignored on
71
210
  insert.
72
- `,maxLength:255}}},ContentItemPage:{type:"object",description:"Paginated collection of content items.",properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},contentItems:{type:"array",items:{"x-go-type":"ContentItem",$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
211
+ `,maxLength:255},rulesOfEngagement:{allOf:[{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
212
+ optionally, dials changed for this item only. Every value can only
213
+ tighten. The client that runs the item resolves the effective rules
214
+ as the stricter of these and the rules that apply to its profile and
215
+ platform without them (the more cautious preset wins, and each dial
216
+ applies only where it is stricter than the resolved preset's own);
217
+ the warm-up and the pause after a sign-in challenge always apply.
218
+ The server validates the shape and stores the value as given; it
219
+ never resolves or loosens it.
220
+ `,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
221
+ least as cautious as the preset its profile and platform
222
+ resolve to.
223
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
224
+ changed; present, the item's rules read as adjusted.
225
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}}],description:`The item's own rules of engagement, which can only tighten the
226
+ rules its profile and platform run under. Omitted on insert, the
227
+ item has none; omitted on update, the stored rules are kept;
228
+ \`null\` on update clears them.
229
+ `,nullable:true,"x-oapi-codegen-extra-tags":{json:"rulesOfEngagement,omitempty"}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the thread's root item. Read on insert; on update it must
230
+ be omitted or equal the stored value.
231
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{json:"threadId,omitempty"}},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the root named by\n`threadId` or an item of the same thread. Requires `threadId`.\nRead on insert; on update it must be omitted or equal the stored\nvalue.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{json:"replyToId,omitempty"}},threadIndex:{type:"integer",description:`Position of the item in its thread, the root counting as 0.
232
+ Required exactly when \`threadId\` is given. Read on insert; on
233
+ update it must be omitted or equal the stored value.
234
+ `,minimum:1},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Omitted on
235
+ insert means none; omitted on update keeps the stored list (old
236
+ clients send the whole item without it); an empty array clears it.
237
+ `,"x-oapi-codegen-extra-tags":{json:"mediaAssetIds,omitempty"}}}},ContentItemRulesOfEngagement:{type:"object","x-generate-db-helpers":true,additionalProperties:false,description:`A content item's own rules of engagement: a Posture preset and,
238
+ optionally, dials changed for this item only. Every value can only
239
+ tighten. The client that runs the item resolves the effective rules
240
+ as the stricter of these and the rules that apply to its profile and
241
+ platform without them (the more cautious preset wins, and each dial
242
+ applies only where it is stricter than the resolved preset's own);
243
+ the warm-up and the pause after a sign-in challenge always apply.
244
+ The server validates the shape and stores the value as given; it
245
+ never resolves or loosens it.
246
+ `,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
247
+ least as cautious as the preset its profile and platform
248
+ resolve to.
249
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
250
+ changed; present, the item's rules read as adjusted.
251
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},ContentItemRulesOfEngagementDials:{type:"object",additionalProperties:false,description:`Dials of a content item's rules of engagement. Each is optional and
252
+ applies only where it is stricter than the resolved preset's own
253
+ value; a dial that would loosen is ignored by the client that runs
254
+ the item.
255
+ `,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}},ContentItemQuietHours:{type:"object",additionalProperties:false,description:"A window of local hours with no public actions, from `start` up to\n`end`, wrapping past midnight when `end` is earlier than `start`.\n",required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},ContentItemPage:{type:"object",description:"Paginated collection of content items.",properties:{page:{type:"integer",description:"Current page number of the result set.",minimum:0},pageSize:{type:"integer",description:"Number of items per page.",minimum:1},totalCount:{type:"integer",description:"Total number of items available.",minimum:0},contentItems:{type:"array",items:{"x-go-type":"ContentItem",$schema:"http://json-schema.org/draft-07/schema#",title:"Content Item Schema",description:`Server-returned content item as persisted by the owning service.
73
256
  Content items carry a row number and a server-computed fingerprint over
74
257
  their canonical values; updates are conditional on the fingerprint the
75
258
  writer read, so stale writes are refused rather than silently applied.
76
- `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{description:"Server-generated content item ID.","x-oapi-codegen-extra-tags":{db:"id"},"x-order":1,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},organizationId:{description:"Owning organization ID. Derived from the authenticated session, never client-settable.","x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values, typed so null, empty string, zero and false differ. Server-computed; used for conditional updates.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{description:`ID of the user whose session created the content item. Derived from the authenticated session, never client-settable, and never changed by an update. Omitted on content items created before it was recorded, and when that user was later purged.
77
- `,"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10,type:"string",format:"uuid","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"}}}},description:"Content items included on this page of results."}}}}}},t=e;module.exports=t;
259
+ An item may carry its own rules of engagement, which can only tighten,
260
+ and may belong to a thread through \`threadId\`, \`replyToId\` and
261
+ \`threadIndex\`. See docs/content-item-contract.md.
262
+ `,type:"object",additionalProperties:false,required:["id","organizationId","profile","rowNumber","fingerprint","createdAt","updatedAt"],properties:{id:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-oapi-codegen-extra-tags":{db:"id"},"x-order":1},organizationId:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"OrganizationID","x-oapi-codegen-extra-tags":{db:"organization_id"},"x-order":2},profile:{type:"string",description:"Subject of the owning profile.",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"profile"},"x-order":3},rowNumber:{type:"integer",description:"Row number of the content item, unique across the live content items of the organization.",minimum:0,"x-oapi-codegen-extra-tags":{db:"row_number"},"x-order":4},fingerprint:{type:"string",description:"Hex digest over the canonical content values (`data`, `profile`, `rowNumber` and, when set, `rulesOfEngagement` and `mediaAssetIds`), typed so null, empty string, zero and false differ. An item without them hashes exactly as it did before the fields existed. The thread fields are fixed at insert and are not part of it. Server-computed; used for conditional updates.\n",minLength:1,maxLength:255,"x-oapi-codegen-extra-tags":{db:"fingerprint"},"x-order":5},data:{type:"object",description:"Content values, stored as a JSON blob.","x-go-type":"core.Map","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-go-type-skip-optional-pointer":true,"x-oapi-codegen-extra-tags":{db:"data"},"x-order":6},createdAt:{description:"Timestamp of content item creation.","x-oapi-codegen-extra-tags":{db:"created_at"},"x-order":7,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},updatedAt:{description:"Timestamp of last content item modification.","x-oapi-codegen-extra-tags":{db:"updated_at"},"x-order":8,type:"string",format:"date-time","x-go-type-skip-optional-pointer":true},deletedAt:{type:"string",format:"date-time",description:"Timestamp when the content item was soft-deleted.",nullable:true,"x-go-type":"core.NullTime","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},"x-oapi-codegen-extra-tags":{db:"deleted_at",json:"deletedAt,omitempty"},"x-order":9},createdBy:{type:"string",format:"uuid",description:"A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.","x-go-type":"uuid.UUID","x-go-type-import":{path:"github.com/gofrs/uuid"},"x-go-name":"CreatedBy","x-oapi-codegen-extra-tags":{db:"created_by",json:"createdBy,omitempty"},"x-order":10},rulesOfEngagement:{description:`The item's own rules of engagement, set by the order that wrote it. They can only tighten: the client that runs the item applies the stricter of these and the rules that apply to the item's profile and platform without them, and the warm-up and the pause after a sign-in challenge always apply. The server validates the shape and stores the value; it does not resolve it. Omitted when the item has none, in which case the item runs under the rules that apply without them.
263
+ `,"x-oapi-codegen-extra-tags":{db:"rules_of_engagement",json:"rulesOfEngagement,omitempty"},"x-order":11,type:"object","x-generate-db-helpers":true,additionalProperties:false,required:["preset"],properties:{preset:{"x-go-type":"posturev1beta3.Posture","x-go-type-import":{path:"github.com/meshery/schemas/models/v1beta3/posture",name:"posturev1beta3"},description:`The preset the item asks for. It applies only when it is at
264
+ least as cautious as the preset its profile and platform
265
+ resolve to.
266
+ `,$schema:"http://json-schema.org/draft-07/schema#",title:"Posture Schema",type:"string",enum:["cautious","standard","brisk"]},dials:{description:`Dials changed for this item only. Omitted when none were
267
+ changed; present, the item's rules read as adjusted.
268
+ `,type:"object",additionalProperties:false,properties:{pace:{type:"string",description:"Typing and interaction pace.",enum:["slow","normal","fast"],"x-enum-varnames":["ContentItemPaceSlow","ContentItemPaceNormal","ContentItemPaceFast"]},minDelaySeconds:{type:"integer",description:"Least time, in seconds, between two public actions on one platform for one profile.",minimum:0,maximum:86400},quietHours:{description:"Local hours with no public actions.",type:"object",additionalProperties:false,required:["start","end"],properties:{start:{type:"integer",description:"Local hour the window opens.",minimum:0,maximum:23},end:{type:"integer",description:"Local hour the window closes.",minimum:0,maximum:23}}},capFraction:{type:"number",format:"double",description:"Share of each built-in daily cap the item may use, above 0 and at most 1.",minimum:0,exclusiveMinimum:true,maximum:1},noMouseMove:{type:"boolean",description:"Whether the item runs without pointer movement."}}}}},threadId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:`ID of the root item of the thread this item belongs to: the first post of a split thread, or the first transmission of a conversation between profiles. Omitted on a standalone item and on a root itself; a root is the item other items name here. Set on insert only.
269
+ `,"x-go-name":"ThreadID","x-oapi-codegen-extra-tags":{db:"thread_id",json:"threadId,omitempty"},"x-order":12},replyToId:{type:"string",format:"uuid","x-go-type":"core.Uuid","x-go-type-import":{path:"github.com/meshery/schemas/models/core",name:"core"},description:"ID of the item this item answers directly: the thread root or another item of the same thread. A split thread's part names the part before it; a reply in a conversation between profiles names the transmission above it. Omitted when the item answers nothing. Never set without `threadId`. Set on insert only.\n","x-go-name":"ReplyToID","x-oapi-codegen-extra-tags":{db:"reply_to_id",json:"replyToId,omitempty"},"x-order":13},threadIndex:{type:"integer",description:"Position of the item in its thread, counting the root as 0. Present exactly when `threadId` is, unique among the live items of the thread, and greater than the position of the item named by `replyToId`. Set on insert only.\n",minimum:1,"x-oapi-codegen-extra-tags":{db:"thread_index",json:"threadIndex,omitempty"},"x-order":14},mediaAssetIds:{type:"array",uniqueItems:true,maxItems:20,"x-go-type":"pq.StringArray","x-go-type-import":{path:"github.com/lib/pq"},"x-go-type-skip-optional-pointer":true,items:{type:"string",format:"uuid",description:"ID of a media_asset in the same organization."},description:`The media assets the item posts, in posting order. Ids only, never URLs. Omitted when the item posts no file.
270
+ `,"x-oapi-codegen-extra-tags":{db:"media_asset_ids",json:"mediaAssetIds,omitempty"},"x-order":15}}},description:"Content items included on this page of results."}}}}}},t=e;module.exports=t;