caplets 0.10.0 → 0.11.0

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 (7) hide show
  1. package/README.md +73 -7
  2. package/caplets/github-cli/CAPLET.md +41 -0
  3. package/caplets/repo-cli/CAPLET.md +37 -0
  4. package/dist/index.js +669 -48
  5. package/package.json +1 -1
  6. package/schemas/caplet.schema.json +139 -0
  7. package/schemas/caplets-config.schema.json +174 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "caplets",
3
- "version": "0.10.0",
3
+ "version": "0.11.0",
4
4
  "description": "Progressive disclosure gateway for MCP servers.",
5
5
  "keywords": [
6
6
  "caplets",
package/schemas/caplet.schema.json CHANGED
@@ -1003,6 +1003,145 @@
1003
1003
  "required": ["baseUrl", "auth", "actions"],
1004
1004
  "additionalProperties": false,
1005
1005
  "description": "HTTP API backend configuration for this Caplet."
1006
+ },
1007
+ "cliTools": {
1008
+ "type": "object",
1009
+ "properties": {
1010
+ "actions": {
1011
+ "type": "object",
1012
+ "propertyNames": {
1013
+ "type": "string",
1014
+ "pattern": "^[a-zA-Z0-9_-]{1,64}$"
1015
+ },
1016
+ "additionalProperties": {
1017
+ "type": "object",
1018
+ "properties": {
1019
+ "description": {
1020
+ "description": "Action capability description.",
1021
+ "type": "string",
1022
+ "minLength": 1
1023
+ },
1024
+ "inputSchema": {
1025
+ "description": "JSON Schema for call_tool arguments.",
1026
+ "type": "object",
1027
+ "propertyNames": {
1028
+ "type": "string"
1029
+ },
1030
+ "additionalProperties": {}
1031
+ },
1032
+ "outputSchema": {
1033
+ "description": "JSON Schema for structuredContent returned by this action.",
1034
+ "type": "object",
1035
+ "propertyNames": {
1036
+ "type": "string"
1037
+ },
1038
+ "additionalProperties": {}
1039
+ },
1040
+ "command": {
1041
+ "type": "string",
1042
+ "minLength": 1,
1043
+ "description": "Executable command to spawn without a shell."
1044
+ },
1045
+ "args": {
1046
+ "description": "Arguments passed to the command.",
1047
+ "type": "array",
1048
+ "items": {
1049
+ "type": "string"
1050
+ }
1051
+ },
1052
+ "env": {
1053
+ "description": "Additional environment variables.",
1054
+ "type": "object",
1055
+ "propertyNames": {
1056
+ "type": "string"
1057
+ },
1058
+ "additionalProperties": {
1059
+ "type": "string"
1060
+ }
1061
+ },
1062
+ "cwd": {
1063
+ "description": "Working directory for this action.",
1064
+ "type": "string",
1065
+ "minLength": 1
1066
+ },
1067
+ "timeoutMs": {
1068
+ "type": "integer",
1069
+ "exclusiveMinimum": 0,
1070
+ "maximum": 9007199254740991
1071
+ },
1072
+ "maxOutputBytes": {
1073
+ "type": "integer",
1074
+ "exclusiveMinimum": 0,
1075
+ "maximum": 9007199254740991
1076
+ },
1077
+ "output": {
1078
+ "type": "object",
1079
+ "properties": {
1080
+ "type": {
1081
+ "type": "string",
1082
+ "enum": ["text", "json"]
1083
+ }
1084
+ },
1085
+ "additionalProperties": false
1086
+ },
1087
+ "annotations": {
1088
+ "type": "object",
1089
+ "properties": {
1090
+ "readOnlyHint": {
1091
+ "type": "boolean"
1092
+ },
1093
+ "destructiveHint": {
1094
+ "type": "boolean"
1095
+ },
1096
+ "idempotentHint": {
1097
+ "type": "boolean"
1098
+ },
1099
+ "openWorldHint": {
1100
+ "type": "boolean"
1101
+ }
1102
+ },
1103
+ "additionalProperties": false
1104
+ }
1105
+ },
1106
+ "required": ["command"],
1107
+ "additionalProperties": false
1108
+ },
1109
+ "description": "Configured CLI actions keyed by stable tool name.",
1110
+ "minProperties": 1
1111
+ },
1112
+ "cwd": {
1113
+ "description": "Default working directory for CLI actions.",
1114
+ "type": "string",
1115
+ "minLength": 1
1116
+ },
1117
+ "env": {
1118
+ "description": "Default environment variables.",
1119
+ "type": "object",
1120
+ "propertyNames": {
1121
+ "type": "string"
1122
+ },
1123
+ "additionalProperties": {
1124
+ "type": "string"
1125
+ }
1126
+ },
1127
+ "timeoutMs": {
1128
+ "type": "integer",
1129
+ "exclusiveMinimum": 0,
1130
+ "maximum": 9007199254740991
1131
+ },
1132
+ "maxOutputBytes": {
1133
+ "type": "integer",
1134
+ "exclusiveMinimum": 0,
1135
+ "maximum": 9007199254740991
1136
+ },
1137
+ "disabled": {
1138
+ "description": "When true, omit this Caplet from discovery.",
1139
+ "type": "boolean"
1140
+ }
1141
+ },
1142
+ "required": ["actions"],
1143
+ "additionalProperties": false,
1144
+ "description": "CLI tools backend configuration for this Caplet."
1006
1145
  }
1007
1146
  },
1008
1147
  "required": ["name", "description"],
package/schemas/caplets-config.schema.json CHANGED
@@ -1130,6 +1130,180 @@
1130
1130
  "required": ["name", "description", "baseUrl", "auth", "actions"],
1131
1131
  "additionalProperties": false
1132
1132
  }
1133
+ },
1134
+ "cliTools": {
1135
+ "default": {},
1136
+ "description": "CLI tools keyed by stable Caplet ID.",
1137
+ "type": "object",
1138
+ "propertyNames": {
1139
+ "type": "string",
1140
+ "pattern": "^[a-zA-Z0-9_-]{1,64}$"
1141
+ },
1142
+ "additionalProperties": {
1143
+ "type": "object",
1144
+ "properties": {
1145
+ "name": {
1146
+ "type": "string",
1147
+ "minLength": 1,
1148
+ "maxLength": 80,
1149
+ "description": "Human-readable CLI tools display name."
1150
+ },
1151
+ "description": {
1152
+ "type": "string",
1153
+ "description": "Capability description shown to agents before CLI actions are disclosed."
1154
+ },
1155
+ "actions": {
1156
+ "type": "object",
1157
+ "propertyNames": {
1158
+ "type": "string",
1159
+ "pattern": "^[a-zA-Z0-9_-]{1,64}$"
1160
+ },
1161
+ "additionalProperties": {
1162
+ "type": "object",
1163
+ "properties": {
1164
+ "description": {
1165
+ "description": "Action capability description.",
1166
+ "type": "string",
1167
+ "minLength": 1
1168
+ },
1169
+ "inputSchema": {
1170
+ "description": "JSON Schema for call_tool arguments.",
1171
+ "type": "object",
1172
+ "propertyNames": {
1173
+ "type": "string"
1174
+ },
1175
+ "additionalProperties": {}
1176
+ },
1177
+ "outputSchema": {
1178
+ "description": "JSON Schema for structuredContent returned by this action.",
1179
+ "type": "object",
1180
+ "propertyNames": {
1181
+ "type": "string"
1182
+ },
1183
+ "additionalProperties": {}
1184
+ },
1185
+ "command": {
1186
+ "type": "string",
1187
+ "minLength": 1,
1188
+ "description": "Executable command to spawn without a shell."
1189
+ },
1190
+ "args": {
1191
+ "description": "Arguments passed to the command.",
1192
+ "type": "array",
1193
+ "items": {
1194
+ "type": "string"
1195
+ }
1196
+ },
1197
+ "env": {
1198
+ "description": "Additional environment variables for the command.",
1199
+ "type": "object",
1200
+ "propertyNames": {
1201
+ "type": "string"
1202
+ },
1203
+ "additionalProperties": {
1204
+ "type": "string"
1205
+ }
1206
+ },
1207
+ "cwd": {
1208
+ "description": "Working directory for this action.",
1209
+ "type": "string",
1210
+ "minLength": 1
1211
+ },
1212
+ "timeoutMs": {
1213
+ "description": "Command timeout in milliseconds.",
1214
+ "type": "integer",
1215
+ "exclusiveMinimum": 0,
1216
+ "maximum": 9007199254740991
1217
+ },
1218
+ "maxOutputBytes": {
1219
+ "description": "Maximum combined stdout and stderr bytes to keep.",
1220
+ "type": "integer",
1221
+ "exclusiveMinimum": 0,
1222
+ "maximum": 9007199254740991
1223
+ },
1224
+ "output": {
1225
+ "type": "object",
1226
+ "properties": {
1227
+ "type": {
1228
+ "default": "text",
1229
+ "description": "How stdout should be represented in structuredContent.",
1230
+ "type": "string",
1231
+ "enum": ["text", "json"]
1232
+ }
1233
+ },
1234
+ "additionalProperties": false
1235
+ },
1236
+ "annotations": {
1237
+ "type": "object",
1238
+ "properties": {
1239
+ "readOnlyHint": {
1240
+ "type": "boolean"
1241
+ },
1242
+ "destructiveHint": {
1243
+ "type": "boolean"
1244
+ },
1245
+ "idempotentHint": {
1246
+ "type": "boolean"
1247
+ },
1248
+ "openWorldHint": {
1249
+ "type": "boolean"
1250
+ }
1251
+ },
1252
+ "additionalProperties": false
1253
+ }
1254
+ },
1255
+ "required": ["command"],
1256
+ "additionalProperties": false
1257
+ },
1258
+ "description": "Configured CLI actions keyed by stable tool name.",
1259
+ "minProperties": 1
1260
+ },
1261
+ "cwd": {
1262
+ "description": "Default working directory for CLI actions.",
1263
+ "type": "string",
1264
+ "minLength": 1
1265
+ },
1266
+ "env": {
1267
+ "description": "Default environment variables for CLI actions.",
1268
+ "type": "object",
1269
+ "propertyNames": {
1270
+ "type": "string"
1271
+ },
1272
+ "additionalProperties": {
1273
+ "type": "string"
1274
+ }
1275
+ },
1276
+ "tags": {
1277
+ "type": "array",
1278
+ "items": {
1279
+ "type": "string",
1280
+ "minLength": 1,
1281
+ "maxLength": 80
1282
+ }
1283
+ },
1284
+ "timeoutMs": {
1285
+ "default": 60000,
1286
+ "description": "Default timeout in milliseconds for CLI actions.",
1287
+ "type": "integer",
1288
+ "exclusiveMinimum": 0,
1289
+ "maximum": 9007199254740991
1290
+ },
1291
+ "maxOutputBytes": {
1292
+ "default": 1000000,
1293
+ "description": "Default maximum combined stdout and stderr bytes to keep.",
1294
+ "type": "integer",
1295
+ "exclusiveMinimum": 0,
1296
+ "maximum": 9007199254740991
1297
+ },
1298
+ "disabled": {
1299
+ "default": false,
1300
+ "description": "When true, omit this CLI tools Caplet.",
1301
+ "type": "boolean"
1302
+ }
1303
+ },
1304
+ "required": ["name", "description", "actions"],
1305
+ "additionalProperties": false
1306
+ }
1133
1307
  }
1134
1308
  },
1135
1309
  "additionalProperties": false