@widgetic/api-contracts 1.11.129 → 1.11.131
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.
- package/README.md +1 -1
- package/mcp-tools.json +625 -29
- package/metadata.json +6 -6
- package/openapi-public.json +386 -1
- package/package.json +1 -1
package/metadata.json
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"package": "@widgetic/api-contracts",
|
|
3
|
-
"version": "1.11.
|
|
3
|
+
"version": "1.11.131",
|
|
4
4
|
"publishTag": "latest",
|
|
5
5
|
"source": {
|
|
6
|
-
"commit": "
|
|
6
|
+
"commit": "9e94404618a92b7b3100cd94111d94360487bf29",
|
|
7
7
|
"branch": null,
|
|
8
8
|
"dirty": false,
|
|
9
9
|
"atOriginMain": true
|
|
10
10
|
},
|
|
11
11
|
"openApi": {
|
|
12
12
|
"file": "openapi-public.json",
|
|
13
|
-
"sha256": "
|
|
13
|
+
"sha256": "a9a488ffb40727a48e4fc7f43145fa804cf39f28e66d1c19127f7363996fb013",
|
|
14
14
|
"paths": 124,
|
|
15
15
|
"operations": 169,
|
|
16
16
|
"servers": [
|
|
@@ -19,9 +19,9 @@
|
|
|
19
19
|
},
|
|
20
20
|
"mcp": {
|
|
21
21
|
"file": "mcp-tools.json",
|
|
22
|
-
"sha256": "
|
|
23
|
-
"contractVersion": "1.
|
|
22
|
+
"sha256": "8a41c548e6453e71d593eb6eadacd0a4265deb0be09ae85e984e43cbca2c5411",
|
|
23
|
+
"contractVersion": "1.22.0",
|
|
24
24
|
"serverName": "widgetic",
|
|
25
|
-
"tools":
|
|
25
|
+
"tools": 48
|
|
26
26
|
}
|
|
27
27
|
}
|
package/openapi-public.json
CHANGED
|
@@ -6109,6 +6109,7 @@
|
|
|
6109
6109
|
],
|
|
6110
6110
|
"operationId": "validateToken",
|
|
6111
6111
|
"summary": "Validate current authentication token",
|
|
6112
|
+
"description": "Describes the credential the request was made with: how it signs in (`tokenType`), what it may do (`scopes`) and the\naccount it belongs to (`userId`). A credential that belongs to the platform itself, and not to a customer's account, is\nheld to no scope: it is answered with `tokenType` `service_key`, `scopes` `[\"*:*\"]` and no `userId`.\n",
|
|
6112
6113
|
"x-access-level": "user",
|
|
6113
6114
|
"x-visibility": "public",
|
|
6114
6115
|
"security": [
|
|
@@ -25995,6 +25996,357 @@
|
|
|
25995
25996
|
"svg": "Example svg"
|
|
25996
25997
|
}
|
|
25997
25998
|
},
|
|
25999
|
+
"WidgetPlanTask": {
|
|
26000
|
+
"type": "object",
|
|
26001
|
+
"required": [
|
|
26002
|
+
"id",
|
|
26003
|
+
"label",
|
|
26004
|
+
"kind",
|
|
26005
|
+
"status"
|
|
26006
|
+
],
|
|
26007
|
+
"description": "One step of the plan the person is shown.",
|
|
26008
|
+
"properties": {
|
|
26009
|
+
"id": {
|
|
26010
|
+
"type": "string",
|
|
26011
|
+
"description": "`t1`, `t2`, ... Stable for the life of the plan."
|
|
26012
|
+
},
|
|
26013
|
+
"label": {
|
|
26014
|
+
"type": "string",
|
|
26015
|
+
"description": "The step, in the language the person wrote in. At most 90 characters."
|
|
26016
|
+
},
|
|
26017
|
+
"kind": {
|
|
26018
|
+
"type": "string",
|
|
26019
|
+
"enum": [
|
|
26020
|
+
"read",
|
|
26021
|
+
"layout",
|
|
26022
|
+
"content",
|
|
26023
|
+
"style",
|
|
26024
|
+
"library",
|
|
26025
|
+
"adapter",
|
|
26026
|
+
"motion",
|
|
26027
|
+
"behavior",
|
|
26028
|
+
"polish",
|
|
26029
|
+
"check",
|
|
26030
|
+
"other"
|
|
26031
|
+
],
|
|
26032
|
+
"description": "What the step is about, so a client can pick an icon."
|
|
26033
|
+
},
|
|
26034
|
+
"status": {
|
|
26035
|
+
"type": "string",
|
|
26036
|
+
"enum": [
|
|
26037
|
+
"pending",
|
|
26038
|
+
"in_progress",
|
|
26039
|
+
"done",
|
|
26040
|
+
"failed"
|
|
26041
|
+
],
|
|
26042
|
+
"description": "Where the step stands. At most one step is `in_progress`."
|
|
26043
|
+
}
|
|
26044
|
+
},
|
|
26045
|
+
"example": {
|
|
26046
|
+
"id": "Example id",
|
|
26047
|
+
"label": "Example label",
|
|
26048
|
+
"kind": "Example kind",
|
|
26049
|
+
"status": "Example status"
|
|
26050
|
+
}
|
|
26051
|
+
},
|
|
26052
|
+
"WidgetPlan": {
|
|
26053
|
+
"type": "object",
|
|
26054
|
+
"required": [
|
|
26055
|
+
"title",
|
|
26056
|
+
"tasks",
|
|
26057
|
+
"decisions",
|
|
26058
|
+
"completed",
|
|
26059
|
+
"activeIndex"
|
|
26060
|
+
],
|
|
26061
|
+
"description": "The plan shown before and during a build, in `metadata.plan` of the generation's operation. It is published when it is made and again each time what a client would draw changes (a handful of updates per build). `metadata.plan` becomes `null` when the build is called off (the request was declined), and a client then hides the plan it showed.",
|
|
26062
|
+
"properties": {
|
|
26063
|
+
"title": {
|
|
26064
|
+
"type": "string",
|
|
26065
|
+
"description": "One line for the whole plan (\"Building a countdown with confetti\")."
|
|
26066
|
+
},
|
|
26067
|
+
"tasks": {
|
|
26068
|
+
"type": "array",
|
|
26069
|
+
"maxItems": 7,
|
|
26070
|
+
"items": {
|
|
26071
|
+
"$ref": "#/components/schemas/WidgetPlanTask"
|
|
26072
|
+
}
|
|
26073
|
+
},
|
|
26074
|
+
"decisions": {
|
|
26075
|
+
"type": "object",
|
|
26076
|
+
"required": [
|
|
26077
|
+
"libraries",
|
|
26078
|
+
"adapters",
|
|
26079
|
+
"look",
|
|
26080
|
+
"motion",
|
|
26081
|
+
"improvements",
|
|
26082
|
+
"notes"
|
|
26083
|
+
],
|
|
26084
|
+
"description": "What the plan decided, for the client to show as it likes (chips, a list, a summary).",
|
|
26085
|
+
"properties": {
|
|
26086
|
+
"libraries": {
|
|
26087
|
+
"type": "array",
|
|
26088
|
+
"items": {
|
|
26089
|
+
"type": "object",
|
|
26090
|
+
"required": [
|
|
26091
|
+
"id",
|
|
26092
|
+
"label",
|
|
26093
|
+
"reason"
|
|
26094
|
+
],
|
|
26095
|
+
"properties": {
|
|
26096
|
+
"id": {
|
|
26097
|
+
"type": "string",
|
|
26098
|
+
"description": "A stable id of the library (`gsap`, `three`, `chart`, ...)."
|
|
26099
|
+
},
|
|
26100
|
+
"label": {
|
|
26101
|
+
"type": "string"
|
|
26102
|
+
},
|
|
26103
|
+
"reason": {
|
|
26104
|
+
"type": "string",
|
|
26105
|
+
"description": "Why the widget needs it, or an empty string."
|
|
26106
|
+
}
|
|
26107
|
+
}
|
|
26108
|
+
}
|
|
26109
|
+
},
|
|
26110
|
+
"adapters": {
|
|
26111
|
+
"type": "array",
|
|
26112
|
+
"description": "The adapters the adapter stage attached on this turn. Empty while that stage is not applied.",
|
|
26113
|
+
"items": {
|
|
26114
|
+
"type": "object",
|
|
26115
|
+
"required": [
|
|
26116
|
+
"id",
|
|
26117
|
+
"label"
|
|
26118
|
+
],
|
|
26119
|
+
"properties": {
|
|
26120
|
+
"id": {
|
|
26121
|
+
"type": "string"
|
|
26122
|
+
},
|
|
26123
|
+
"label": {
|
|
26124
|
+
"type": "string"
|
|
26125
|
+
}
|
|
26126
|
+
}
|
|
26127
|
+
}
|
|
26128
|
+
},
|
|
26129
|
+
"look": {
|
|
26130
|
+
"type": "string",
|
|
26131
|
+
"description": "What the widget should look like, from what the person provided (words, pictures, a copied page, a Figma frame). May be empty."
|
|
26132
|
+
},
|
|
26133
|
+
"motion": {
|
|
26134
|
+
"type": "array",
|
|
26135
|
+
"items": {
|
|
26136
|
+
"type": "string"
|
|
26137
|
+
},
|
|
26138
|
+
"description": "The animations to apply. At most 3."
|
|
26139
|
+
},
|
|
26140
|
+
"improvements": {
|
|
26141
|
+
"type": "array",
|
|
26142
|
+
"items": {
|
|
26143
|
+
"type": "string"
|
|
26144
|
+
},
|
|
26145
|
+
"description": "Improvements that do not change what was asked. At most 3."
|
|
26146
|
+
},
|
|
26147
|
+
"notes": {
|
|
26148
|
+
"type": "array",
|
|
26149
|
+
"items": {
|
|
26150
|
+
"type": "string"
|
|
26151
|
+
},
|
|
26152
|
+
"description": "Anything else particular to this widget. At most 3."
|
|
26153
|
+
},
|
|
26154
|
+
"responsive": {
|
|
26155
|
+
"type": "object",
|
|
26156
|
+
"nullable": true,
|
|
26157
|
+
"description": "How the widget behaves on mobile, tablet and desktop (layout reflow, stacking, sizing). Always present on a first build; null on edits unless the model supplies it.",
|
|
26158
|
+
"required": [
|
|
26159
|
+
"mobile",
|
|
26160
|
+
"tablet",
|
|
26161
|
+
"desktop"
|
|
26162
|
+
],
|
|
26163
|
+
"properties": {
|
|
26164
|
+
"mobile": {
|
|
26165
|
+
"type": "string",
|
|
26166
|
+
"maxLength": 120
|
|
26167
|
+
},
|
|
26168
|
+
"tablet": {
|
|
26169
|
+
"type": "string",
|
|
26170
|
+
"maxLength": 120
|
|
26171
|
+
},
|
|
26172
|
+
"desktop": {
|
|
26173
|
+
"type": "string",
|
|
26174
|
+
"maxLength": 120
|
|
26175
|
+
}
|
|
26176
|
+
}
|
|
26177
|
+
}
|
|
26178
|
+
}
|
|
26179
|
+
},
|
|
26180
|
+
"completed": {
|
|
26181
|
+
"type": "integer",
|
|
26182
|
+
"description": "How many steps are `done`."
|
|
26183
|
+
},
|
|
26184
|
+
"activeIndex": {
|
|
26185
|
+
"type": "integer",
|
|
26186
|
+
"nullable": true,
|
|
26187
|
+
"description": "The index in `tasks` of the step in progress, or null when none is."
|
|
26188
|
+
}
|
|
26189
|
+
},
|
|
26190
|
+
"example": {
|
|
26191
|
+
"title": "Example title",
|
|
26192
|
+
"tasks": [
|
|
26193
|
+
"Example WidgetPlanTask"
|
|
26194
|
+
],
|
|
26195
|
+
"decisions": {},
|
|
26196
|
+
"completed": 42,
|
|
26197
|
+
"activeIndex": 42
|
|
26198
|
+
}
|
|
26199
|
+
},
|
|
26200
|
+
"WidgetClarificationOption": {
|
|
26201
|
+
"type": "object",
|
|
26202
|
+
"required": [
|
|
26203
|
+
"id",
|
|
26204
|
+
"label",
|
|
26205
|
+
"recommended"
|
|
26206
|
+
],
|
|
26207
|
+
"properties": {
|
|
26208
|
+
"id": {
|
|
26209
|
+
"type": "string",
|
|
26210
|
+
"description": "`q1o1`, `q1o2`, ... Stable within the card."
|
|
26211
|
+
},
|
|
26212
|
+
"label": {
|
|
26213
|
+
"type": "string",
|
|
26214
|
+
"description": "The option text, at most 60 characters, including the parenthesised recommendation word on the recommended option (for example `Three plans (Recommended)`)."
|
|
26215
|
+
},
|
|
26216
|
+
"recommended": {
|
|
26217
|
+
"type": "boolean",
|
|
26218
|
+
"description": "True for the one option the assistant recommends. It is always the first option when set. The server composes the recommendation word into `label`; clients may still draw a badge."
|
|
26219
|
+
}
|
|
26220
|
+
},
|
|
26221
|
+
"example": {
|
|
26222
|
+
"id": "Example id",
|
|
26223
|
+
"label": "Example label",
|
|
26224
|
+
"recommended": true
|
|
26225
|
+
}
|
|
26226
|
+
},
|
|
26227
|
+
"WidgetClarificationQuestion": {
|
|
26228
|
+
"type": "object",
|
|
26229
|
+
"required": [
|
|
26230
|
+
"id",
|
|
26231
|
+
"question",
|
|
26232
|
+
"options",
|
|
26233
|
+
"recommendedWord",
|
|
26234
|
+
"allowOther"
|
|
26235
|
+
],
|
|
26236
|
+
"properties": {
|
|
26237
|
+
"id": {
|
|
26238
|
+
"type": "string",
|
|
26239
|
+
"description": "`q1`, `q2`, ..."
|
|
26240
|
+
},
|
|
26241
|
+
"question": {
|
|
26242
|
+
"type": "string"
|
|
26243
|
+
},
|
|
26244
|
+
"recommendedWord": {
|
|
26245
|
+
"type": "string",
|
|
26246
|
+
"maxLength": 24,
|
|
26247
|
+
"description": "The localized word placed in parentheses on the recommended option's label (default `Recommended`)."
|
|
26248
|
+
},
|
|
26249
|
+
"options": {
|
|
26250
|
+
"type": "array",
|
|
26251
|
+
"maxItems": 5,
|
|
26252
|
+
"description": "Two to five options with the recommended one first; empty for a question answered in words only.",
|
|
26253
|
+
"items": {
|
|
26254
|
+
"$ref": "#/components/schemas/WidgetClarificationOption"
|
|
26255
|
+
}
|
|
26256
|
+
},
|
|
26257
|
+
"allowOther": {
|
|
26258
|
+
"type": "boolean",
|
|
26259
|
+
"description": "Whether the person may answer in their own words (the \"Other...\" row). Always true when there are no options."
|
|
26260
|
+
}
|
|
26261
|
+
},
|
|
26262
|
+
"example": {
|
|
26263
|
+
"id": "Example id",
|
|
26264
|
+
"question": "Example question",
|
|
26265
|
+
"recommendedWord": "Example recommendedWord",
|
|
26266
|
+
"options": [
|
|
26267
|
+
"Example WidgetClarificationOption"
|
|
26268
|
+
],
|
|
26269
|
+
"allowOther": true
|
|
26270
|
+
}
|
|
26271
|
+
},
|
|
26272
|
+
"WidgetClarification": {
|
|
26273
|
+
"type": "object",
|
|
26274
|
+
"required": [
|
|
26275
|
+
"message",
|
|
26276
|
+
"questions",
|
|
26277
|
+
"filesRead"
|
|
26278
|
+
],
|
|
26279
|
+
"description": "The card of questions the assistant puts to the person before building, in `metadata.clarification` of an operation that completed with `metadata.outcome` `needs_answers`. Nothing was built and the credit was returned. The same words are saved in the chat as a plain-text assistant message.",
|
|
26280
|
+
"properties": {
|
|
26281
|
+
"message": {
|
|
26282
|
+
"type": "string",
|
|
26283
|
+
"description": "The sentence that introduces the card."
|
|
26284
|
+
},
|
|
26285
|
+
"questions": {
|
|
26286
|
+
"type": "array",
|
|
26287
|
+
"maxItems": 4,
|
|
26288
|
+
"items": {
|
|
26289
|
+
"$ref": "#/components/schemas/WidgetClarificationQuestion"
|
|
26290
|
+
}
|
|
26291
|
+
},
|
|
26292
|
+
"filesRead": {
|
|
26293
|
+
"type": "array",
|
|
26294
|
+
"items": {
|
|
26295
|
+
"type": "string"
|
|
26296
|
+
},
|
|
26297
|
+
"description": "The paths of the widget's files the questions were judged against, for a \"Read N files\" row."
|
|
26298
|
+
}
|
|
26299
|
+
},
|
|
26300
|
+
"example": {
|
|
26301
|
+
"message": "Example message",
|
|
26302
|
+
"questions": [
|
|
26303
|
+
"Example WidgetClarificationQuestion"
|
|
26304
|
+
],
|
|
26305
|
+
"filesRead": []
|
|
26306
|
+
}
|
|
26307
|
+
},
|
|
26308
|
+
"WidgetNextStep": {
|
|
26309
|
+
"type": "object",
|
|
26310
|
+
"required": [
|
|
26311
|
+
"id",
|
|
26312
|
+
"label",
|
|
26313
|
+
"kind",
|
|
26314
|
+
"recommended"
|
|
26315
|
+
],
|
|
26316
|
+
"description": "One suggested next improvement, in `metadata.nextSteps` of a completed generation. The label is a complete request: sending it as the next message is the whole action. The first suggestion is always the recommended one; the chips saved under the reply carry no flag, so a client applies the same rule after a reload.",
|
|
26317
|
+
"properties": {
|
|
26318
|
+
"id": {
|
|
26319
|
+
"type": "string",
|
|
26320
|
+
"description": "`n1`, `n2`, ..."
|
|
26321
|
+
},
|
|
26322
|
+
"label": {
|
|
26323
|
+
"type": "string",
|
|
26324
|
+
"description": "The request, at most 80 characters."
|
|
26325
|
+
},
|
|
26326
|
+
"kind": {
|
|
26327
|
+
"type": "string",
|
|
26328
|
+
"enum": [
|
|
26329
|
+
"content",
|
|
26330
|
+
"style",
|
|
26331
|
+
"layout",
|
|
26332
|
+
"behavior",
|
|
26333
|
+
"animation",
|
|
26334
|
+
"data",
|
|
26335
|
+
"other"
|
|
26336
|
+
]
|
|
26337
|
+
},
|
|
26338
|
+
"recommended": {
|
|
26339
|
+
"type": "boolean",
|
|
26340
|
+
"description": "True for the first suggestion and false for the others."
|
|
26341
|
+
}
|
|
26342
|
+
},
|
|
26343
|
+
"example": {
|
|
26344
|
+
"id": "Example id",
|
|
26345
|
+
"label": "Example label",
|
|
26346
|
+
"kind": "Example kind",
|
|
26347
|
+
"recommended": true
|
|
26348
|
+
}
|
|
26349
|
+
},
|
|
25998
26350
|
"ErrorResponse": {
|
|
25999
26351
|
"type": "object",
|
|
26000
26352
|
"required": [
|
|
@@ -27697,7 +28049,40 @@
|
|
|
27697
28049
|
"metadata": {
|
|
27698
28050
|
"type": "object",
|
|
27699
28051
|
"additionalProperties": true,
|
|
27700
|
-
"description": "What the operation tells about its work. A finished composition duplication names the new composition in `newCompositionId`, and lists any problem with its database in `warnings` (absent when there is none).\n"
|
|
28052
|
+
"description": "What the operation tells about its work. A finished composition duplication names the new composition in `newCompositionId`, and lists any problem with its database in `warnings` (absent when there is none). A code generation whose request declared `clientCapabilities` also tells what that client asked to show: `plan` while it builds, `outcome` `needs_answers` with the card in `clarification` when it asked before building, and `nextSteps` once it is done. A key whose part the client did not declare is never present.\n",
|
|
28053
|
+
"properties": {
|
|
28054
|
+
"plan": {
|
|
28055
|
+
"nullable": true,
|
|
28056
|
+
"allOf": [
|
|
28057
|
+
{
|
|
28058
|
+
"$ref": "#/components/schemas/WidgetPlan"
|
|
28059
|
+
}
|
|
28060
|
+
],
|
|
28061
|
+
"description": "The plan of a code generation, published when it is made and again each time a step changes (`pending`, `in_progress`, `done`, `failed`). `null` when the build was called off, so the client hides the plan it showed.\n"
|
|
28062
|
+
},
|
|
28063
|
+
"outcome": {
|
|
28064
|
+
"type": "string",
|
|
28065
|
+
"enum": [
|
|
28066
|
+
"needs_answers"
|
|
28067
|
+
],
|
|
28068
|
+
"description": "`needs_answers` on a code generation that completed by asking questions: nothing was built, the credit was returned, and the card is in `clarification`. Absent on every other outcome.\n"
|
|
28069
|
+
},
|
|
28070
|
+
"clarification": {
|
|
28071
|
+
"allOf": [
|
|
28072
|
+
{
|
|
28073
|
+
"$ref": "#/components/schemas/WidgetClarification"
|
|
28074
|
+
}
|
|
28075
|
+
],
|
|
28076
|
+
"description": "The card of questions, present with `outcome` `needs_answers`."
|
|
28077
|
+
},
|
|
28078
|
+
"nextSteps": {
|
|
28079
|
+
"type": "array",
|
|
28080
|
+
"description": "Suggested next improvements of a completed code generation, the recommended one first. Absent when none were made in time or the build was not kept.\n",
|
|
28081
|
+
"items": {
|
|
28082
|
+
"$ref": "#/components/schemas/WidgetNextStep"
|
|
28083
|
+
}
|
|
28084
|
+
}
|
|
28085
|
+
}
|
|
27701
28086
|
},
|
|
27702
28087
|
"error": {
|
|
27703
28088
|
"type": "string",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@widgetic/api-contracts",
|
|
3
|
-
"version": "1.11.
|
|
3
|
+
"version": "1.11.131",
|
|
4
4
|
"description": "What the Widgetic API and the Widgetic MCP server accept, as data: the public OpenAPI description and the MCP tool contract. Written by the Widgetic API gateway; the Widgetic CLI is generated from it.",
|
|
5
5
|
"author": "Widgetic",
|
|
6
6
|
"license": "SEE LICENSE IN LICENSE",
|